scrapbox-cosense-mcp

Inglés | japonés

Inglés

Servidor MCP para cosense/scrapbox .

Características

get_page
- Obtener el contenido de la página desde cosense/Scrapbox
  - Entrada: Título de la página
  - Salida: Contenido de la página, metadatos, enlaces e información del editor
list_pages
- Obtener una lista de páginas del proyecto (máximo 1000 páginas)
  - Salida: Lista de títulos de páginas del proyecto
search_pages
- Búsqueda de texto completo en todas las páginas del proyecto (máximo 100 páginas)
  - Admite búsqueda básica, búsqueda AND, búsqueda OR y búsqueda NOT
  - Salida: Lista de títulos de páginas en los resultados de búsqueda
create_pages
- Generar URL de páginas
  - Entrada: Título de la página y texto del cuerpo opcional
  - Salida: URL que se puede abrir en un navegador

Desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Reconstrucción automática durante el desarrollo:

npm run watch

Instalación

git clone https://github.com/worldnine/scrapbox-cosense-mcp.git cd scrapbox-cosense-mcp npm install npm run build

Para utilizar con Claude Desktop, agregue la configuración del servidor de la siguiente manera:

Para MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Para Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "mcpServers": { "scrapbox-cosense-mcp": { "command": "npx", "args": ["github:worldnine/scrapbox-cosense-mcp"], "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid", // Required for private projects "COSENSE_PAGE_LIMIT": "25", // Optional (default: 100) "COSENSE_SORT_METHOD": "created", // Optional (default: "updated") "SERVICE_LABEL": "scrapbox(cosense)" // Optional (default: "cosense(scrapbox)") } } } }

Variables de entorno

Este servidor utiliza las siguientes variables de entorno:

Variables de entorno requeridas

COSENSE_PROJECT_NAME : Nombre del proyecto
COSENSE_SID : ID de sesión para la autenticación de Scrapbox/Cosense (obligatorio para proyectos privados)

Variables de entorno opcionales

API_DOMAIN : Dominio de la API (predeterminado: "scrapbox.io")
SERVICE_LABEL : Identificador del servicio (predeterminado: "cosense (scrapbox)")
COSENSE_PAGE_LIMIT : Límite de obtención de páginas iniciales (1-1000, predeterminado: 100)
COSENSE_SORT_METHOD : Orden de obtención de la página inicial (actualizada/creada/accedida/vinculada/vistas/título, predeterminado: actualizado)

Comportamiento de la variable ambiental

COSENSE_PROJECT_NAME : Variable de entorno requerida. El servidor saldrá con un error si no se configura.
COSENSE_SID : Obligatorio para acceder a proyectos privados. Si no se configura, solo se podrá acceder a los proyectos públicos.
API_DOMINIO :
- Utilice "scrapbox.io" si no está configurado
- Si bien no está verificado con dominios distintos de "scrapbox.io" en el entorno del autor, esta opción existe en caso de que algunos entornos requieran "cosen.se".
LÍMITE DE PÁGINAS DE COSENSE :
- Utiliza 100 si no está configurado
- Utiliza 100 si el valor no es válido (no numérico o fuera de rango)
- Rango válido: 1-1000
MÉTODO DE ORDENACIÓN COSENSE :
- Utiliza 'actualizado' si no está configurado
- Utiliza 'actualizado' si el valor no es válido
- No afecta el comportamiento de la herramienta list_pages (solo se utiliza para la búsqueda inicial de recursos)

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser un desafío. Se recomienda utilizar MCP Inspector . Puedes ejecutarlo con:

npm run inspector

El Inspector proporciona una URL para acceder a las herramientas de depuración en el navegador.

Related MCP server: MCP File System Server

japonés

Este es un servidor MCP para cosense/scrapbox .

función

get_page
- Obtener el contenido de la página desde cosense/Scrapbox
  - Entrada: Título de la página
  - Salida: Contenido de la página, metadatos, enlaces, información del editor
list_pages
- Obtener una lista de páginas de un proyecto (hasta 1000)
  - Salida: Una lista de títulos de páginas en el proyecto
search_pages
- Búsqueda de texto completo en todas las páginas de un proyecto (hasta 100 resultados)
  - Admite búsqueda básica, búsqueda AND, búsqueda OR y búsqueda NOT
  - Salida: Lista de títulos de páginas en los resultados de búsqueda
create_pages
- Generar URL para la página
  - Entrada: Título de la página y texto del cuerpo opcional
  - Salida: Una URL que se puede abrir en un navegador

Método de desarrollo

Instalar dependencias:

npm install

Construir el servidor:

npm run build

Reconstrucción automática durante el desarrollo:

npm run watch

Cómo instalar

git clone https://github.com/worldnine/scrapbox-cosense-mcp.git cd scrapbox-cosense-mcp npm install npm run build

Para usarlo con Claude Desktop, agregue la siguiente configuración de servidor:

Para MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json Para Windows: %APPDATA%/Claude/claude_desktop_config.json

{ "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", // オプション（デフォルト: 100） "COSENSE_SORT_METHOD": "created", // オプション（デフォルト: "updated"） "SERVICE_LABEL": "scrapbox(cosense)" // オプション（デフォルト: "cosense(scrapbox)"） } } } }

variables ambientales

Este servidor utiliza las siguientes variables de entorno:

Variables de entorno requeridas

COSENSE_PROJECT_NAME : Nombre del proyecto
COSENSE_SID : ID de sesión de autenticación de Scrapbox/Cosense (obligatorio para proyectos privados)

Variables de entorno opcionales

API_DOMAIN : Dominio de la API (predeterminado: "scrapbox.io")
SERVICE_LABEL : Nombre de identificación del servicio (predeterminado: "cosense (scrapbox)")
COSENSE_PAGE_LIMIT : Número de páginas a recuperar inicialmente (1-1000, valor predeterminado: 100)
COSENSE_SORT_METHOD : Orden de páginas en la recuperación inicial (actualizado/creado/accedido/vinculado/vistas/título, predeterminado: actualizado)

Comportamiento de las variables del entorno

COSENSE_PROJECT_NAME : Esta es una variable de entorno obligatoria. Si no se configura, el servidor saldrá con un error al iniciarse.
COSENSE_SID : Obligatorio para acceder a proyectos privados. Si no se configura, solo se podrá acceder a los proyectos públicos.
API_DOMINIO :
- Si no se configura, se utilizará "scrapbox.io".
- En el entorno del autor no se han verificado valores distintos a "scrapbox.io", pero puede haber entornos en los que no funcione a menos que sea "cosen.se", por lo que esta es una opción por si acaso.
LÍMITE DE PÁGINAS DE COSENSE :
- Si no se establece, utilice 100
- Para valores no válidos (no numéricos o fuera de rango) utilice 100
- Rango válido: 1-1000
MÉTODO DE ORDENACIÓN COSENSE :
- Si no se configura, se utiliza "actualizado".
- Para valores no válidos utilice 'actualizado'
- No afecta el funcionamiento de la herramienta list_pages (se utiliza solo al obtener recursos iniciales)

Cómo depurar

Los servidores MCP se comunican a través de stdio, por lo que puede ser difícil depurarlos. Recomendamos utilizar MCP Inspector . Esto se puede hacer con el siguiente comando:

npm run inspector

Inspector proporciona una URL para acceder a las herramientas de depuración en su navegador.