Introducción al Proyecto Scrapbox Cosense MCP Server

Resumen del Proyecto

scrapbox-cosense-mcp es un servidor MCP (Model Context Protocol) diseñado específicamente para la plataforma cosense/scrapbox. Desarrollado por worldnine y alojado en GitHub, este proyecto tiene como objetivo proporcionar una interfaz estandarizada para aplicaciones de IA con la base de conocimiento de Scrapbox.

¿Qué es Scrapbox/Cosense?

Cosense es una plataforma de gestión del conocimiento cuya filosofía central es que "la clave de la productividad reside en el conocimiento". Permite a los usuarios compartir experiencias, acumular conocimiento y lograr fácilmente un crecimiento compuesto del conocimiento dentro de la organización.

Funcionalidades Principales

1. get_page (Obtener Página)

• Descripción de la Función: Obtiene el contenido de una página desde cosense/Scrapbox.
• Parámetros de Entrada: Título de la página.
• Contenido de Salida: Contenido de la página, metadatos, información de enlaces e información del editor.

2. list_pages (Listar Páginas)

• Descripción de la Función: Obtiene la lista de páginas dentro del proyecto.
• Condiciones: Devuelve un máximo de 1000 páginas.
• Contenido de Salida: Lista de títulos de todas las páginas dentro del proyecto.

3. search_pages (Buscar Páginas)

• Descripción de la Función: Realiza una búsqueda de texto completo dentro del proyecto.
• Capacidad de Búsqueda: Soporta búsqueda básica, búsqueda AND, búsqueda OR y búsqueda NOT.
• Condiciones: Devuelve un máximo de 100 resultados de búsqueda.
• Contenido de Salida: Lista de títulos de las páginas que cumplen con los criterios de búsqueda.

4. create_pages (Crear Páginas)

• Descripción de la Función: Genera la URL de una página.
• Parámetros de Entrada: Título de la página y contenido del cuerpo opcional.
• Contenido de Salida: URL que se puede abrir en un navegador.

Instalación y Configuración

Instalación para Desarrollo Local

# Clonar el proyecto
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# Instalar dependencias
npm install

# Construir el servidor
npm run build

# Reconstrucción automática durante el desarrollo
npm run watch

Configuración para la Integración con Claude Desktop

Para usar este servidor en Claude Desktop, es necesario agregar la configuración del servidor en el archivo de configuración:

Ruta del archivo de configuración en macOS:

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

Ruta del archivo de configuración en Windows:

%APPDATA%/Claude/claude_desktop_config.json

Ejemplo de Configuración:

{
  "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)"
      }
    }
  }
}

Explicación de las Variables de Entorno

Variables Obligatorias

• COSENSE_PROJECT_NAME: Nombre del proyecto (obligatorio).
  • Si no se establece, el servidor se cerrará con un error al iniciar.

Variables Opcionales

• COSENSE_SID: ID de sesión de autenticación de Scrapbox/Cosense.

  • Requerido para acceder a proyectos privados.
  • Si no se establece, solo se pueden acceder a proyectos públicos.

• API_DOMAIN: Dominio de la API (predeterminado: "scrapbox.io").

  • Proporciona una opción para entornos que podrían necesitar usar "cosen.se".

• SERVICE_LABEL: Identificador del servicio (predeterminado: "cosense (scrapbox)").

• COSENSE_PAGE_LIMIT: Límite inicial de obtención de páginas (predeterminado: 100).

  • Rango válido: 1-1000.
  • Si está fuera del rango, se utiliza automáticamente el valor predeterminado.

• COSENSE_SORT_METHOD: Orden inicial de obtención de páginas (predeterminado: "updated").

  • Valores posibles: updated/created/accessed/linked/views/title.
  • Solo afecta la obtención inicial de recursos, no afecta la herramienta list_pages.

Herramientas de Depuración

Dado que el servidor MCP se comunica a través de stdio, la depuración puede ser difícil. El proyecto recomienda usar MCP Inspector para la depuración:

npm run inspector

Inspector proporcionará una URL que se puede acceder en un navegador para usar las herramientas de depuración.

Características del Proyecto

1. Interfaz Estandarizada: Este servidor facilita la interacción con proyectos cosense/Scrapbox, permitiendo a los usuarios recuperar, listar, buscar y crear páginas, al tiempo que admite varias operaciones de consulta y acceso seguro a proyectos privados.

2. Seguridad: Soporta el acceso a proyectos privados a través de un ID de sesión, garantizando la seguridad de los datos.

3. Configuración Flexible: Proporciona múltiples opciones de variables de entorno, adaptándose a diferentes escenarios de uso.

4. Amigable para el Desarrollo: Ofrece reconstrucción automática en modo de desarrollo y herramientas de depuración especializadas.

Casos de Uso

• Automatización de la Gestión del Conocimiento: Integra Scrapbox para implementar funciones de lectura y escritura de páginas para la gestión del conocimiento, notas colaborativas y aplicaciones de chatbot.
• Mejora de Asistentes de IA: Proporciona a las aplicaciones de IA la capacidad de acceder a bases de conocimiento estructuradas.
• Optimización de la Recuperación de Contenido: Recupera y busca contenido de Scrapbox de manera eficiente a través de una API estandarizada.
• Integración de Herramientas de Colaboración: Integra las funciones de colaboración de Scrapbox en otras herramientas de IA.

Arquitectura Técnica

Este proyecto se basa en la arquitectura Model Context Protocol, donde los desarrolladores pueden exponer datos a través de un servidor MCP o construir aplicaciones de IA (clientes MCP). El proyecto está desarrollado en Node.js y TypeScript, siguiendo las especificaciones del protocolo estándar MCP.

Resumen

scrapbox-cosense-mcp es una implementación completa de un servidor MCP que proporciona una ruta estandarizada para que las aplicaciones de IA interactúen con la base de conocimiento de Scrapbox. No solo admite operaciones básicas de página, sino que también ofrece potentes funciones de búsqueda y acceso seguro a proyectos privados, lo que lo convierte en una herramienta ideal para construir sistemas inteligentes de gestión del conocimiento.