Meridian MCP 是 Meridian 商业服务平台的 MCP 服务器,面向创业公司创始人服务场景(如公司注册、签证等)。它把平台上的服务、服务请求、工作流步骤、付款和会议以 Model Context Protocol 工具与资源的形式暴露出来,供兼容 MCP 的客户端调用。
主要能力:
- 暴露服务(services)、服务请求(service requests)、工作流步骤(workflow steps)、付款(payments)和会议(meetings)等资源与工具。
- 支持通过 MCP 协议在多种客户端中运行,包括 Claude Code、Codex CLI、Claude Desktop、pi 以及其他兼容 MCP 的客户端。
- 已列入官方 MCP Registry(io.github.meridian-silkdev/meridian-mcp)和 Glama。
- 提供 Agent Auth 发现能力:/.well-known/agent-configuration 暴露基于能力的短时 JWT、设备认证/CIBA 审批。代理可使用长期有效的 mrd_ 密钥或限定范围的 Agent Auth 授权(参见 meridian-skills 的 meridian-api skill)。
- 未设置 MERIDIAN_API_KEY 时,所有工具仍会响应,说明将调用哪个端点以及需要配置什么,因此服务器可在 dry-run/演示模式下安全运行。
使用方式:
- 通过 npx 运行:npx -y @meridiantoolkit/mcp。
- 复制 .env.example 或直接设置环境变量。
- 在项目根目录放置 .mcp.json(可团队共享并提交到 git)。
- Codex 从 ~/.codex/config.toml(或受信任项目的项目级 .codex/config.toml)读取 MCP 服务器;也可通过 CLI 添加:codex mcp add meridian -- npx -y @meridiantoolkit/mcp。同一配置由 Codex CLI、IDE 扩展和 ChatGPT 桌面应用共享。Codex 没有插件/技能系统,其等价物就是该 MCP 服务器加项目指引;可将 AGENTS.md.example 复制到项目的 AGENTS.md 以获得与其他地方技能包相同的工具使用指引。
- Claude Desktop / pi:添加到 MCP 配置(Claude Desktop:claude_desktop_config.json;pi:.pi/settings.json → mcpServers,或 pi --mcp)。
发布与 CI:
- .github/workflows/ci.yml:每次推送到 main 和每个 PR 执行 npm ci、类型检查、构建、npm test(真实 stdio 冒烟测试套件)。
- .github/workflows/publish.yml:在发布 GitHub Release 时触发,重新运行完整测试套件,检查发布标签与 package.json 的版本一致,然后通过 npm 的 Trusted Publishing(OIDC)执行 npm publish --provenance(无需创建或轮换 NPM_TOKEN 密钥);并通过 mcp-publisher login github-oidc + mcp-publisher publish 发布/更新官方 MCP Registry 上的列表(同样使用 OIDC,无需密钥)。server.json 的版本会自动同步到发布标签。该步骤设置了 continue-on-error: true——注册表明确处于预览阶段,因此其故障不会阻塞实际的 npm 发布。
- mcpName 要求:package.json 中有 "mcpName": "io.github.meridian-silkdev/meridian-mcp" 字段,注册表的包验证器需要它来确认 npm 包与 GitHub 验证的服务器身份由同一所有者发布。若在 server.json 中重命名服务器,也需更新此字段,否则发布会返回 400。
- 已知上游 bug 及规避:交互式 mcp-publisher login github 设备流在 GitHub 组织命名空间下发布时可靠地返回 403(无论成员资格是否公开、是否为 Owner 角色,参见 modelcontextprotocol/registry#1537,撰写时仍开放)。在组织自有仓库中运行的 GitHub Actions 工作流内使用 github-oidc 可完全绕过该问题,因为它验证的是工作流的仓库身份而非检查人类账户的组织列表。这就是注册表发布步骤放在 CI 而非手动本地命令的原因。
- 首次手动发布后的一次性设置:在包的 npmjs.com 页面 → Settings → Trusted Publisher → GitHub Actions,指向 meridian-silkdev/meridian-mcp,工作流 publish.yml。此后发布新版本只需相应操作。
适用场景:
- 创业公司创始人通过兼容 MCP 的 AI 客户端浏览服务、创建和跟踪请求、验证付款、安排会议。
- 需要在 dry-run/演示模式下安全试用 MCP 集成的开发者。
限制:
- 需要 MERIDIAN_API_KEY 才能进行真实调用;未配置时仅返回说明性响应。
- 官方 MCP Registry 处于预览阶段,发布步骤可能不稳定(已设置 continue-on-error)。
- Codex 无插件/技能系统,需依赖 MCP 服务器加项目指引。
- 关于具体收费、价格、平台支持范围等细节,资料中暂未提供。