
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 分
請在儲存庫或註冊中心條目中宣告授權條款。