Cosense MCP Server

🚀 Cosense MCP 服務器

Cosense MCP 服務器是一個專門為 Cosense 提供服務的 MCP 服務器，能助力用戶更高效地與 Cosense 進行交互。

✨ 主要特性

以下工具可用於與 Cosense 頁面進行交互：

• get_page：根據指定標題獲取頁面。
• list_pages：列出資源中的可用頁面。
• search_pages：搜索包含指定查詢字符串的頁面。
• insert_lines：在指定行後插入文本到頁面中。

📦 安裝指南

MCP 客戶端配置

以下環境變量是必需的：

• COSENSE_PROJECT_NAME：項目名稱。
• COSENSE_SID：會話 ID，用於身份驗證。
  • 寫入頁面和讀取私有頁面時需要。
  • 處理時需小心，因為它包含敏感信息。
  • 更多細節，請參見 scrapboxlab/connect.sid。

從 npm 註冊表運行

JSR 註冊表配置

此包依賴於 @cosense/std 和 @cosense/types，這些包託管在 JSR 上。使用 npx 之前，需要全局配置 JSR 註冊表：

• 對於 Linux/macOS：

echo "@jsr:registry=https://npm.jsr.io" >> ~/.npmrc

• 對於 Windows (PowerShell)：

echo "@jsr:registry=https://npm.jsr.io" >> $env:USERPROFILE\.npmrc

或者如果你不想修改全局設置，可直接從源代碼運行（參見下文）。

客戶端 JSON 配置

配置完 JSR 註冊表後，配置你的 MCP 客戶端：

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yosider/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

從源代碼運行

克隆和構建

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

客戶端 JSON 配置

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "npx",
      "args": ["-y", "/path/to/cosense-mcp-server"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。我們推薦使用 MCP 檢查器，它作為一個包腳本提供：

npm run inspect

檢查器會提供一個在瀏覽器中訪問調試工具的 URL。

📄 許可證

文檔中未提及許可證相關信息。

致謝

這個項目是從 funwarioisii/cosense-mcp-server 分叉而來的。