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僅桌面效率與工作流知識與記憶

概覽

AI 產生的概覽

透過 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 的網路。僅限桌面用戶端。
安裝前請注意
此權杖具備組織知識庫的讀寫權限,應視為機密,只存放在用戶端設定中。助理可附加觀察與決策、建立關聯,會變更共用的組織資料;刪除需經管理員核准的請求。所有請求(包括你查詢的內容)都會轉送到 ModusOp 的遠端服務。舊版 0.x 的權杖與工具已停用,現有設定需改用新的 Brain 權杖。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Modusop Mcp,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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):

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

Cursor / Cline / Continue.dev — .cursor/mcp.json (or the equivalent):

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

3. Restart your client

Quit and reopen. The Modus Brain tools should appear in the MCP indicator within a few seconds.

Env vars

VariableRequiredDefaultNotes
MODUSOP_API_TOKENyes—Brain token from brain.modusop.app
MODUSOP_BRAIN_URLnohttps://brain.modusop.app/mcpOverride only for local Brain development

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 to
  • search_knowledge — semantic search over the org KB
  • get_chunk — deep-dive on a specific search result
  • list_recent — recently indexed KB items
  • get_client_brief — synthesised client one-pager
  • add_observation — append a note
  • add_decision — record context + decision + rationale
  • link_observation — typed link between two chunks
  • request_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_TOKEN with the new token
  • No other config change needed — same command, same args, 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

bash
git clone https://github.com/jwwd-repos/modusop-mcp.gitcd modusop-mcpnpm installMODUSOP_API_TOKEN=... npm run dev

The proxy reads JSON-RPC on stdin and writes responses on stdout, so test it manually with:

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

Licence

See LICENSE.md.

來源:README.md,提交 f744cbd

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.2.5最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。