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 知識庫交互的標準化途徑。它不僅支持基本的頁面操作，還提供了強大的搜尋功能和安全的私有項目訪問能力，是構建智能知識管理系統的理想工具。