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 分叉而来的。