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

英语|日本人

英语

用于cosense/scrapbox 的MCP 服务器。

特征

  • get_page
    • 从 cosense/Scrapbox 获取页面内容
      • 输入：页面标题
      • 输出：页面内容、元数据、链接和编辑器信息
  • list_pages
    • 获取项目中的页面列表（最多 1000 页）
      • 输出：项目中的页面标题列表
  • search_pages
    • 在项目的所有页面中进行全文搜索（最多 100 页）
      • 支持基本搜索、AND 搜索、OR 搜索和 NOT 搜索
      • 输出：搜索结果中的页面标题列表
  • create_pages
    • 生成页面 URL
      • 输入：页面标题和可选正文
      • 输出：可以在浏览器中打开的 URL

发展

安装依赖项：

npm install

构建服务器：

npm run build

开发期间自动重建：

npm run watch

安装

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

要与 Claude Desktop 一起使用，请按如下方式添加服务器配置：

对于 MacOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json对于 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)") } } } }

环境变量

该服务器使用以下环境变量：

必需的环境变量

  • COSENSE_PROJECT_NAME ：项目名称
  • COSENSE_SID ：Scrapbox/Cosense 身份验证的会话 ID（私人项目必需）

可选环境变量

  • API_DOMAIN ：API 域（默认值：“scrapbox.io”）
  • SERVICE_LABEL ：服务标识符（默认值：“cosense (scrapbox)”）
  • COSENSE_PAGE_LIMIT ：初始页面获取限制（1-1000，默认值：100）
  • COSENSE_SORT_METHOD ：初始页面获取顺序（更新/创建/访问/链接/查看/标题，默认值：更新）

环境变量行为

  • COSENSE_PROJECT_NAME ：必需的环境变量。如果未设置，服务器将因错误退出。
  • COSENSE_SID ：访问私人项目所需。如果未设置，则只能访问公共项目。
  • API 域：
    • 如果未设置，请使用“scrapbox.io”
    • 虽然在作者的环境中未使用除“scrapbox.io”之外的其他域进行验证，但在某些环境需要“cosen.se”的情况下，此选项存在
  • COSENSE_PAGE_LIMIT ：
    • 如果未设置则使用 100
    • 如果值无效（非数字或超出范围），则使用 100
    • 有效范围：1-1000
  • COSENSE_SORT_METHOD ：
    • 如果未设置，则使用“已更新”
    • 如果值无效，则使用“已更新”
    • 不影响 list_pages 工具行为（仅用于初始资源获取）

调试

由于 MCP 服务器通过 stdio 进行通信，因此调试可能具有挑战性。建议使用MCP Inspector 。您可以使用以下命令运行它：

npm run inspector

Inspector 提供了一个 URL 来访问浏览器中的调试工具。

日本人

这是cosense/scrapbox的 MCP 服务器。

功能

  • get_page
    • 从 cosense/Scrapbox 获取页面内容
      • 输入：页面标题
      • 输出：页面内容、元数据、链接、编辑器信息
  • list_pages
    • 获取项目中的页面列表（最多 1000 个）
      • 输出：项目中的页面标题列表
  • search_pages
    • 对项目中的所有页面进行全文搜索（最多 100 个结果）
      • 支持基本搜索、AND 搜索、OR 搜索和 NOT 搜索
      • 输出：搜索结果中的页面标题列表
  • create_pages
    • 生成页面的 URL
      • 输入：页面标题和可选正文
      • 输出：可以在浏览器中打开的 URL

开发方法

安装依赖项：

npm install

构建服务器：

npm run build

开发期间自动重建：

npm run watch

如何安装

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

要将其与 Claude Desktop 一起使用，请添加以下服务器配置：

对于 MacOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json对于 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)"） } } } }

环境变量

该服务器使用以下环境变量：

必需的环境变量

  • COSENSE_PROJECT_NAME ：项目名称
  • COSENSE_SID ：Scrapbox/Cosense 身份验证会话 ID（私人项目必需）

可选环境变量

  • API_DOMAIN ：API 域（默认值：“scrapbox.io”）
  • SERVICE_LABEL ：服务标识名称（默认值：“cosense (scrapbox)”）
  • COSENSE_PAGE_LIMIT ：初始检索的页数（1-1000，默认值：100）
  • COSENSE_SORT_METHOD ：初始检索时的页面顺序（更新/创建/访问/链接/查看/标题，默认值：更新）

环境变量的行为

  • COSENSE_PROJECT_NAME ：这是一个必需的环境变量。如果未设置，服务器将在启动时因错误而退出。
  • COSENSE_SID ：访问私人项目所需。如果未设置，则只有公共项目可访问。
  • API 域：
    • 如果未设置，则将使用“scrapbox.io”。
    • 在笔者的环境中，除了“scrapbox.io”以外的值尚未验证，但可能存在除非是“cosen.se”否则无法工作的环境，因此这只是以防万一的一个选项。
  • COSENSE_PAGE_LIMIT ：
    • 如果未设置，则使用 100
    • 对于无效值（非数字或超出范围）使用 100
    • 有效范围：1-1000
  • COSENSE_SORT_METHOD ：
    • 如果未设置，则使用“更新”。
    • 对于无效值，请使用“更新”
    • 不影响list_pages工具的运行（仅在获取初始资源时使用）

如何调试

MCP 服务器通过 stdio 进行通信，因此调试起来比较困难。我们建议使用MCP Inspector 。可以使用以下命令完成此操作：

npm run inspector

Inspector 提供了一个 URL 来访问浏览器中的调试工具。

You must be authenticated.

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

Tools

该服务器方便与 cosense/Scrapbox 项目的交互，使用户能够检索、列出、搜索和创建页面，同时支持各种查询操作和对私有项目的安全访问。

  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