Scrapbox Cosense MCP Server

scrapbox-cosense-mcp

英语|日本人

英语

用于cosense/scrapbox 的MCP 服务器。

特征

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

发展

安装依赖项：

构建服务器：

开发期间自动重建：

安装

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

对于 MacOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json对于 Windows： %APPDATA%/Claude/claude_desktop_config.json

环境变量

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

必需的环境变量

• 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 。您可以使用以下命令运行它：

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

日本人

这是cosense/scrapbox的 MCP 服务器。

功能

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

开发方法

安装依赖项：

构建服务器：

开发期间自动重建：

如何安装

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

对于 MacOS： ~/Library/Application\ Support/Claude/claude_desktop_config.json对于 Windows： %APPDATA%/Claude/claude_desktop_config.json

环境变量

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

必需的环境变量

• 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 。可以使用以下命令完成此操作：

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