Cosense MCP Server

Cosense MCP 服务

一个用于 Cosense 的 MCP 服务。

工具

以下工具可用于与 Cosense 页面交互：

• get_page：获取指定标题的页面
• list_pages：列出资源中的可用页面
• search_pages：搜索包含指定查询字符串的页面
• insert_lines：在页面中的指定行后插入文本

安装

前提条件

设置以下环境变量：

• COSENSE_PROJECT_NAME — 你的 Cosense 项目名称。
• COSENSE_SID — 用于身份验证的会话 Cookie。写入页面和读取私有页面时需要。请将其视为机密信息。有关详情，请参阅 https://scrapbox.io/scrapboxlab/connect.sid。

VS Code 用户

使用以下任一一键安装按钮：

注意：点击按钮后，请在配置中将 your_project_name 和 your_sid 替换为实际值。手动设置时，也可以直接编辑 .vscode/mcp.json。

Claude Desktop 用户

将以下任一配置添加到你的 claude_desktop_config.json：

使用 pnpm

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

使用 yarn

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

使用 npx

此软件包依赖托管在 JSR 上的软件包。npx 需要先将 JSR 注册表添加到 ~/.npmrc。

步骤 1：将 JSR 注册表添加到 ~/.npmrc

Linux/macOS：

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

Windows（PowerShell）：

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

步骤 2：添加配置

{
  "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
pnpm install
pnpm run build

然后配置 MCP 客户端以使用本地构建：

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

调试

由于 MCP 服务通过标准输入输出（stdio）通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过软件包脚本运行：

pnpm run inspect

Inspector 将提供一个 URL，用于在浏览器中访问调试工具。

致谢

此项目基于 funwarioisii/cosense-mcp-server 分叉而来。