modusop-mcp

@modusop/mcp-server

面向 Modus Brain 的 Stdio→HTTP 代理 — 让任何支持 MCP 的 AI 客户端（Claude Desktop、Cursor、Cline、Continue.dev 等）都能访问你的 ModusOp 组织知识库。

功能

此软件包是一个轻量级代理。一端使用 MCP stdio 传输，另一端将每个 JSON-RPC 请求转发到 Modus Brain 的 HTTP MCP 端点。

所有工具实现都位于 Modus Brain 本身 — ModusOp 发布新的 Brain 工具后，此软件包的所有安装都会在下一个请求时自动获取该工具。无需重新发布、无需升级版本，也无需用户执行任何操作。

如果你的 AI 客户端原生支持远程 HTTP MCP，则完全不需要此软件包 — 直接将其指向 https://brain.modusop.app/mcp 即可。此软件包是为仅支持 stdio 的客户端提供的。

设置

1. 获取 Brain 令牌

在 brain.modusop.app 登录，生成一个标注为将使用它的设备或人员的令牌，并复制明文值（该值仅显示一次）。

2. 添加到 AI 客户端的 MCP 配置中

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "modusop-brain": {
      "command": "npx",
      "args": ["-y", "@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "mo_brain_..."
      }
    }
  }
}

Cursor / Cline / Continue.dev — .cursor/mcp.json（或相应的配置文件）：

{
  "mcpServers": {
    "modusop-brain": {
      "command": "npx",
      "args": ["-y", "@modusop/mcp-server"],
      "env": {
        "MODUSOP_API_TOKEN": "mo_brain_..."
      }
    }
  }
}

3. 重启客户端

退出并重新打开。几秒钟内，Modus Brain 工具就应该会显示在 MCP 指示器中。

环境变量

变量	必需	默认值	说明
MODUSOP_API_TOKEN	是	—	来自 brain.modusop.app 的 Brain 令牌
MODUSOP_BRAIN_URL	否	https://brain.modusop.app/mcp	仅在本地开发 Brain 时覆盖

可用工具

以 Brain 提供的工具为准 — tools/list 会反映当前工具集。v1.0.0 版本提供：

• whoami — 确认此令牌对应的用户和组织
• search_knowledge — 对组织知识库进行语义搜索
• get_chunk — 深入查看特定搜索结果
• list_recent — 最近编入索引的知识库条目
• get_client_brief — 综合整理的客户简介
• add_observation — 追加备注
• add_decision — 记录上下文、决策和理由
• link_observation — 在两个区块之间建立类型化链接
• request_delete — 需管理员批准的删除

从 0.x 迁移

此软件包的 0.x 版本在包内实现工具，并使用来自 /settings/api-tokens 的 MO API 令牌与 ModusOp 较旧的 /api/mcp 端点通信。v1.0.0 不再支持此路径：

• 在 brain.modusop.app 生成新的 Brain 令牌，而不是 MO API 令牌
• 将 MODUSOP_API_TOKEN 的值替换为新令牌
• 无需更改其他配置 — command、args 和环境变量名称都保持不变

旧工具（search_projects、search_clients、get_client_context、start_timer 等）已不再包含在此软件包的目录中。它们已被弃用，改由 Brain 工具取代；Brain 工具覆盖相同的功能范围，还支持知识库搜索和追加写入。如果需要旧工具集，请固定使用 @modusop/[email protected] — 它仍可正常工作，但不会收到更新。

本地开发

git clone https://github.com/jwwd-repos/modusop-mcp.git
cd modusop-mcp
npm install
MODUSOP_API_TOKEN=... npm run dev

代理从 stdin 读取 JSON-RPC，并将响应写入 stdout，因此可以使用以下命令手动测试：

echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"whoami"}}' \
  | MODUSOP_API_TOKEN=... npm run dev

许可证

请参阅 LICENSE.md。