Home
Login
worldnine/scrapbox-cosense-mcpPlease refer to the latest official releases for information GitHub Homepage

一个为 Scrapbox/Cosense 平台设计的 MCP 服务器，支持页面检索、搜索和创建功能

MITTypeScript 24worldninescrapbox-cosense-mcp Last Updated: 2025-06-15

Scrapbox Cosense MCP Server 项目介绍

项目概述

scrapbox-cosense-mcp 是一个专门为 cosense/scrapbox 平台设计的 MCP（Model Context Protocol）服务器。该项目由 worldnine 开发，托管在 GitHub 上，旨在为 AI 应用程序提供与 Scrapbox 知识库的标准化接口。

什么是 Scrapbox/Cosense？

Cosense 是一个知识管理平台，其核心理念是"生产力的关键在于知识"。它允许用户分享经验、积累知识，并在组织内轻松实现知识的复合增长。

核心功能

1. get_page（获取页面）

  • 功能描述：从 cosense/Scrapbox 获取页面内容
  • 输入参数：页面标题
  • 输出内容：页面内容、元数据、链接信息和编辑者信息

2. list_pages（列出页面）

  • 功能描述：获取项目内的页面列表
  • 限制条件：最多返回 1000 个页面
  • 输出内容：项目内所有页面的标题列表

3. search_pages（搜索页面）

  • 功能描述：在项目内进行全文搜索
  • 搜索能力：支持基本搜索、AND 搜索、OR 搜索和 NOT 搜索
  • 限制条件：最多返回 100 个搜索结果
  • 输出内容：符合搜索条件的页面标题列表

4. create_pages（创建页面）

  • 功能描述：生成页面 URL
  • 输入参数：页面标题和可选的正文内容
  • 输出内容：可在浏览器中打开的 URL

安装和配置

本地开发安装

# 克隆项目
git clone https://github.com/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp

# 安装依赖
npm install

# 构建服务器
npm run build

# 开发时自动重构建
npm run watch

Claude Desktop 集成配置

要在 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",
        "COSENSE_SORT_METHOD": "created",
        "SERVICE_LABEL": "scrapbox(cosense)"
      }
    }
  }
}

环境变量说明

必需变量

  • COSENSE_PROJECT_NAME：项目名称（必需）
    • 如果未设置，服务器启动时会报错退出

可选变量

  • COSENSE_SID：Scrapbox/Cosense 认证会话 ID

    • 访问私有项目时必需
    • 未设置时只能访问公共项目

  • API_DOMAIN：API 域名（默认："scrapbox.io"）

    • 为某些可能需要使用 "cosen.se" 的环境提供选项

  • SERVICE_LABEL：服务标识符（默认："cosense (scrapbox)"）

  • COSENSE_PAGE_LIMIT：初始页面获取限制（默认：100）

    • 有效范围：1-1000
    • 超出范围时自动使用默认值

  • COSENSE_SORT_METHOD：初始页面获取顺序（默认："updated"）

    • 可选值：updated/created/accessed/linked/views/title
    • 仅影响初始资源获取，不影响 list_pages 工具

调试工具

由于 MCP 服务器通过 stdio 进行通信，调试可能比较困难。项目推荐使用 MCP Inspector 进行调试：

npm run inspector

Inspector 会提供一个 URL，可在浏览器中访问调试工具。

项目特点

  1. 标准化接口：该服务器促进与 cosense/Scrapbox 项目的交互，使用户能够检索、列出、搜索和创建页面，同时支持各种查询操作和对私有项目的安全访问

  2. 安全性：支持通过会话 ID 访问私有项目，确保数据安全

  3. 灵活配置：提供多种环境变量选项，适应不同使用场景

  4. 开发友好：提供开发模式的自动重构建和专门的调试工具

使用场景

  • 知识管理自动化：集成 Scrapbox 以实现知识管理、协作笔记和聊天机器人应用的页面读写功能
  • AI 助手增强：为 AI 应用程序提供访问结构化知识库的能力
  • 内容检索优化：通过标准化 API 高效检索和搜索 Scrapbox 内容
  • 协作工具集成：将 Scrapbox 的协作功能整合到其他 AI 工具中

技术架构

该项目基于 Model Context Protocol 架构，开发者可以通过 MCP 服务器暴露数据，或构建 AI 应用程序（MCP 客户端）。项目使用 Node.js 和 TypeScript 开发，遵循 MCP 标准协议规范。

总结

scrapbox-cosense-mcp 是一个功能完整的 MCP 服务器实现，为 AI 应用程序提供了与 Scrapbox 知识库交互的标准化途径。它不仅支持基本的页面操作，还提供了强大的搜索功能和安全的私有项目访问能力，是构建智能知识管理系统的理想工具。

Star History Chart