
Modusop Mcp
io.github.jwwd-repos由 GitHub 账号 jwwd-repos 发布v0.2.5更新于 Oct 24, 2026
MCP server for ModusOp — projects, tasks, time tracking, and retainers for AI assistants.
概览
通过 stdio 代理把 MCP 客户端连接到 ModusOp 的 Modus Brain,让助手检索组织知识库并记录笔记与决策。
- 可以做什么
- 识别当前令牌所属的用户与组织
- 对组织知识库做语义搜索、深入查看某条结果、列出最近索引的内容
- 生成客户一页纸摘要
- 追加观察记录、记录带背景与理由的决策,并在内容块之间建立带类型的关联
- 发起需管理员审批的删除请求
- 适用场景
- 当团队把项目、客户与决策知识放在 ModusOp 的 Modus Brain 中,并希望助手在工作时检索这些内容或补充笔记时适用。仅对只支持 stdio 的客户端需要;支持远程 HTTP MCP 的客户端可直接连接 Brain 端点。
- 运行要求
- 通过 npx 运行 npm 包 @modusop/mcp-server,需要 Node.js。需要在 MODUSOP_API_TOKEN 环境变量中提供来自 brain.modusop.app 的 Brain 令牌;可用 MODUSOP_API_URL 覆盖 API 基础地址。需要能访问 ModusOp API 的网络。仅限桌面客户端。
安装
在 SourceWeft 中
- 打开 控制台中的 Modusop Mcp,将其添加到工作区。
- 为需要使用其工具的对话启用该服务。
Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。
其他 MCP 客户端
参照 仓库 中的启动说明。
README
@modusop/mcp-server
Stdio→HTTP proxy for Modus Brain — gives any MCP-aware AI client (Claude Desktop, Cursor, Cline, Continue.dev, etc.) access to your ModusOp organisation's knowledge base.
What it does
This package is a thin proxy. It speaks the MCP stdio transport on one end and forwards every JSON-RPC request to Modus Brain's HTTP MCP endpoint on the other.
All tool implementations live in Modus Brain itself — when ModusOp ships a new Brain tool, every install of this package picks it up automatically on the next request. No re-publish, no version bump, no user action needed.
If your AI client speaks remote HTTP MCP natively, you don't need this package at all — point it directly at https://brain.modusop.app/mcp. This package exists for clients that only speak stdio.
Setup
1. Get a Brain token
Sign in at brain.modusop.app, generate a token labelled for the device or person who'll use it, copy the plaintext value (you only see it once).
2. Add to your AI client's MCP config
Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Cursor / Cline / Continue.dev — .cursor/mcp.json (or the equivalent):
3. Restart your client
Quit and reopen. The Modus Brain tools should appear in the MCP indicator within a few seconds.
Env vars
Available tools
Whatever Brain exposes — tools/list reflects the current set. As of v1.0.0:
whoami— identify the user + org this token is scoped tosearch_knowledge— semantic search over the org KBget_chunk— deep-dive on a specific search resultlist_recent— recently indexed KB itemsget_client_brief— synthesised client one-pageradd_observation— append a noteadd_decision— record context + decision + rationalelink_observation— typed link between two chunksrequest_delete— admin-gated removal
Migrating from 0.x
Versions 0.x of this package implemented tools in-package and talked to ModusOp's older /api/mcp endpoint with an MO API token from /settings/api-tokens. v1.0.0 retires that path:
- Generate a new Brain token at brain.modusop.app, not an MO API token
- Replace the value of
MODUSOP_API_TOKENwith the new token - No other config change needed — same
command, sameargs, same env var name
Old tools (search_projects, search_clients, get_client_context, start_timer, etc.) are no longer present in this package's catalogue. They've been retired in favour of Brain's tools, which cover the same surface plus knowledge-base search and append-writes. If you need the old tool set, pin to @modusop/[email protected] — it still works but won't receive updates.
Local development
The proxy reads JSON-RPC on stdin and writes responses on stdout, so test it manually with:
Licence
See LICENSE.md.
来源:README.md,提交 f744cbd
工具
0版本历史
1- v0.2.5最新Sep 16, 2026
评分
已满足适用检查项的 40%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通25 分
请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。
- 已声明认证方式10 分
请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。