Cosense MCP Server

用于Cosense的MCP服务器。

工具

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

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

MCP客户端配置

需要以下环境变量：

• COSENSE_PROJECT_NAME: 项目名称
• COSENSE_SID: 会话ID，用于身份验证
  • 写入页面或读取私有页面时需要此参数
  • 请注意，它包含敏感信息
  • 更多详情，请参阅scrapboxlab/connect.sid
• NODE_ENV: 执行环境（development 或 production）
  • 控制日志行为
  • 在development模式下，显示调试日志
  • 在production模式下，抑制调试日志

从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"
      }
    }
  }
}

为了开发调试，可以在env部分添加 "NODE_ENV": "development"。请注意，在.env文件中设置环境变量不会生效，因为执行时机的问题，请使用MCP客户端配置。

调试

由于MCP服务器通过标准I/O通信，调试可能会比较困难。我们推荐使用MCP Inspector，它作为一个包脚本提供：

npm run inspect

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

致谢

该项目是从funwarioisii/cosense-mcp-server分叉而来。