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 注册表配置

此软件包依赖于托管在 JSR 上的 @cosense/std 和 @cosense/types。在使用 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 服务器通过 stdio 进行通信，因此调试可能具有挑战性。 我们建议使用 MCP Inspector，它作为包脚本提供：

npm run inspect

Inspector 将提供一个 URL 以访问浏览器中的调试工具。

鸣谢

此项目 fork 自 funwarioisii/cosense-mcp-server。