Cosense MCP 服务器

一个为 Cosense 提供服务的 MCP 服务器。

工具

以下工具可用于与 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 分叉而来的。