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 分

    请在仓库或注册中心条目中声明许可证。