Présentation du projet Scrapbox Cosense MCP Server

Aperçu du projet

scrapbox-cosense-mcp est un serveur MCP (Model Context Protocol) spécialement conçu pour la plateforme cosense/scrapbox. Développé par worldnine et hébergé sur GitHub, ce projet vise à fournir une interface standardisée aux applications d'IA pour interagir avec les bases de connaissances Scrapbox.

Qu'est-ce que Scrapbox/Cosense ?

Cosense est une plateforme de gestion des connaissances dont la philosophie centrale est que "la clé de la productivité réside dans la connaissance". Elle permet aux utilisateurs de partager leurs expériences, d'accumuler des connaissances et de réaliser facilement une croissance composite des connaissances au sein d'une organisation.

Fonctionnalités principales

1. get_page (Obtenir une page)

• Description de la fonction : Récupérer le contenu d'une page depuis cosense/Scrapbox.
• Paramètre d'entrée : Titre de la page.
• Contenu de sortie : Contenu de la page, métadonnées, informations sur les liens et informations sur l'éditeur.

2. list_pages (Lister les pages)

• Description de la fonction : Obtenir la liste des pages dans un projet.
• Limitation : Retourne au maximum 1000 pages.
• Contenu de sortie : Liste des titres de toutes les pages du projet.

3. search_pages (Rechercher des pages)

• Description de la fonction : Effectuer une recherche en texte intégral dans un projet.
• Capacités de recherche : Prend en charge la recherche de base, la recherche AND, la recherche OR et la recherche NOT.
• Limitation : Retourne au maximum 100 résultats de recherche.
• Contenu de sortie : Liste des titres des pages correspondant aux critères de recherche.

4. create_pages (Créer des pages)

• Description de la fonction : Générer l'URL d'une page.
• Paramètres d'entrée : Titre de la page et contenu du corps facultatif.
• Contenu de sortie : URL pouvant être ouverte dans un navigateur.

Installation et configuration

Installation pour le développement local

# Cloner le projet
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# Installer les dépendances
npm install

# Construire le serveur
npm run build

# Reconstruire automatiquement pendant le développement
npm run watch

Configuration pour l'intégration avec Claude Desktop

Pour utiliser ce serveur dans Claude Desktop, vous devez ajouter les paramètres du serveur dans le fichier de configuration :

Chemin du fichier de configuration macOS :

~/Library/Application\ Support/Claude/claude_desktop_config.json

Chemin du fichier de configuration Windows :

%APPDATA%/Claude/claude_desktop_config.json

Exemple de configuration :

{
  "mcpServers": {
    "scrapbox-cosense-mcp": {
      "command": "npx",
      "args": ["github:worldnine/scrapbox-cosense-mcp"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid",
        "COSENSE_PAGE_LIMIT": "25",
        "COSENSE_SORT_METHOD": "created",
        "SERVICE_LABEL": "scrapbox(cosense)"
      }
    }
  }
}

Description des variables d'environnement

Variables obligatoires

• COSENSE_PROJECT_NAME : Nom du projet (obligatoire)
  • Si elle n'est pas définie, le serveur s'arrêtera avec une erreur au démarrage.

Variables facultatives

• COSENSE_SID : ID de session d'authentification Scrapbox/Cosense

  • Requis pour accéder aux projets privés.
  • Si elle n'est pas définie, seuls les projets publics sont accessibles.

• API_DOMAIN : Nom de domaine de l'API (par défaut : "scrapbox.io")

  • Fournit une option pour certains environnements qui peuvent nécessiter l'utilisation de "cosen.se".

• SERVICE_LABEL : Identifiant du service (par défaut : "cosense (scrapbox)")

• COSENSE_PAGE_LIMIT : Limite initiale de récupération des pages (par défaut : 100)

  • Plage valide : 1-1000
  • La valeur par défaut est utilisée automatiquement si elle est hors de portée.

• COSENSE_SORT_METHOD : Ordre de récupération initial des pages (par défaut : "updated")

  • Valeurs possibles : updated/created/accessed/linked/views/title
  • N'affecte que la récupération initiale des ressources, pas l'outil list_pages.

Outils de débogage

Étant donné que le serveur MCP communique via stdio, le débogage peut être difficile. Le projet recommande d'utiliser MCP Inspector pour le débogage :

npm run inspector

Inspector fournira une URL qui peut être visitée dans un navigateur pour accéder aux outils de débogage.

Caractéristiques du projet

1. Interface standardisée : Ce serveur facilite l'interaction avec les projets cosense/Scrapbox, permettant aux utilisateurs de récupérer, lister, rechercher et créer des pages, tout en prenant en charge diverses opérations de requête et un accès sécurisé aux projets privés.

2. Sécurité : Prend en charge l'accès aux projets privés via un ID de session, garantissant la sécurité des données.

3. Configuration flexible : Fournit diverses options de variables d'environnement pour s'adapter à différents scénarios d'utilisation.

4. Convivial pour le développement : Fournit une reconstruction automatique en mode développement et des outils de débogage dédiés.

Cas d'utilisation

• Automatisation de la gestion des connaissances : Intégrer Scrapbox pour la gestion des connaissances, les notes collaboratives et les applications de chatbot avec des fonctionnalités de lecture et d'écriture de pages.
• Amélioration des assistants d'IA : Fournir aux applications d'IA la capacité d'accéder à des bases de connaissances structurées.
• Optimisation de la récupération de contenu : Récupérer et rechercher efficacement du contenu Scrapbox via une API standardisée.
• Intégration d'outils de collaboration : Intégrer les fonctionnalités de collaboration de Scrapbox dans d'autres outils d'IA.

Architecture technique

Ce projet est basé sur l'architecture Model Context Protocol, où les développeurs peuvent exposer des données via un serveur MCP ou créer des applications d'IA (clients MCP). Le projet est développé en Node.js et TypeScript, en suivant les spécifications du protocole standard MCP.

Conclusion

scrapbox-cosense-mcp est une implémentation complète du serveur MCP qui fournit un moyen standardisé pour les applications d'IA d'interagir avec les bases de connaissances Scrapbox. Il prend non seulement en charge les opérations de page de base, mais offre également de puissantes fonctionnalités de recherche et un accès sécurisé aux projets privés, ce qui en fait un outil idéal pour la construction de systèmes de gestion des connaissances intelligents.