Skip to main content
Glama
Sign In
enesjakozh

Scrapbox Cosense MCP Server

by worldnine
GitHub
TypeScript
MIT License
12
  • Apple
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides access to Scrapbox/Cosense pages, allowing retrieval of page content, metadata, links, and editor information, listing pages in a project, full-text search across pages, and generating page URLs.

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.

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.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Tools

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

  1. English
    1. Features
    2. Development
    3. Installation
    4. Environment Variables
    5. Debugging
  2. 日本語
    1. 機能
      1. 開発方法
        1. インストール方法
          1. 環境変数
            1. 必須の環境変数
            2. オプションの環境変数
            3. 環境変数の挙動について
            4. デバッグ方法

          Related Resources

          Appeared in Searches

          ID: 8huixkwpe2