Mantra 文档

简体中文

English

简体中文

English

主题

MCP Hub ​

Mantra v0.7.0 引入了强大的 MCP Hub，它是 Mantra 打造 AI 编程工具中枢的核心。

什么是 MCP Hub？ ​

MCP Hub 是由 Anthropic 发起的 MCP (Model Context Protocol) 开放标准的完整实现。它将多个 MCP 服务聚合为一个符合最新规范的 Streamable HTTP 服务端，充当了"流量中继"和"管理面板"的双重角色：

  • 统一入口：将多个 MCP 服务（支持 stdio、SSE 等所有标准协议）聚合。
  • 透明接管：MCP Hub 可以接管 Claude Code, Cursor 等工具的 MCP 配置，让你在 Mantra 中统一管理所有 AI 工具的权限。
  • 安全管控：通过图形化界面统一管理服务的关联状态和工具的启用/禁用。

主要功能 ​

  1. 服务管理：添加、编辑和开关 MCP 服务，支持所有标准 MCP 协议。
  2. 环境变量管理：为 MCP 服务配置全局或特定项目的环境变量，支持敏感信息隐藏。
  3. OAuth 凭证管理：安全存储远程 MCP 服务（如 Google Drive）所需的认证令牌。
  4. 状态监控：实时查看 Hub 的运行状态、连接的客户端以及活跃的服务数量。

配置接管 ​

MCP Hub 的核心工作流是接管：从你现有的 AI 工具中一键导入 MCP 配置，无需手动重新配置。

支持接管的工具 ​

工具用户级配置项目级配置
Claude Code✅✅（本地作用域）
Cursor✅✅
Gemini CLI✅✅
Codex✅✅

智能合并引擎 ​

接管时，MCP Hub 使用三档分类策略处理配置差异：

  • 新增：Hub 中不存在的服务，直接导入
  • 更新：已有服务但配置有变化，提示更新
  • 冲突：关键字段不一致，提供差异对比和手动决策

每次接管操作前会自动备份原始配置，支持原子性恢复。

项目级管理 ​

v0.8.2 新增了项目级 MCP 管理能力：

  • 侧边栏管理面板：从项目右键菜单直接管理 MCP 服务关联
  • 作用域配置导入：基于项目作用域自动扫描和过滤配置
  • 可检测配置增强：自动识别新增服务，过滤已有服务

工具权限管理 (Tool Policy) ​

Mantra 实现了业界领先的项目级工具粒度权限控制。

核心能力 ​

  • 项目级策略：你可以为不同的项目设置不同的工具访问权限。例如，在"项目 A"中允许 AI 修改文件，但在"项目 B"中仅允许 AI 读取文件。
  • 精确权限管理：你可以精确到单个工具（如 read_file, shell_execute）设置权限：
    • 启用 (Enable)：允许 AI 使用该工具。
    • 禁用 (Disable)：禁止 AI 使用该工具，MCP Hub 会拦截调用请求。
  • 动态接管：通过接管其他 AI 工具的配置，Mantra 可以强制执行这些安全策略，即使你使用的是原生的 Claude Code。
  • 严格模式：基于项目上下文过滤服务，确保仅暴露与当前项目相关的 MCP 服务。

MCP Roots 机制 ​

MCP Hub 实现了 MCP Roots 协议，支持项目级配置感知：

  • AI 工具（Claude Code、Gemini CLI、Codex、Cursor）通过 roots/list 请求告知当前工作目录
  • MCP Hub 使用最长前缀匹配 (LPM) 算法，根据项目上下文自动路由到对应的 MCP 服务
  • 无需手动切换项目，MCP Hub 自动感知你正在工作的项目

内置 MCP 调试器 (Inspector) ​

为了方便开发者调试 MCP 服务，Mantra 内置了专业的 Inspector：

  • 实时日志：查看 AI 模型与 MCP 服务之间的 JSON-RPC 通信。
  • 手动触发：在 Inspector 中手动调用工具，验证服务是否返回正确的上下文。
  • 错误排查：快速定位连接超时、权限错误或数据格式不匹配问题。

备份与恢复 ​

MCP Hub 提供完善的备份恢复机制，保障配置安全：

  • 原子性操作：接管和恢复操作均为原子性，失败时自动回滚
  • 版本保留：保留最近 5 个备份版本
  • 完整性校验：恢复前自动验证备份文件的完整性
  • 自动清理：过期备份自动清理，无需手动管理

系统托盘集成 ​

为了确保 MCP Hub 在后台持续提供服务，Mantra 深度集成了系统托盘：

  • 后台运行：关闭主窗口后，Mantra 依然在后台运行，保持 MCP 服务的可用性。
  • 快速唤起：通过托盘菜单一键打开 Hub、Inspector 或退出应用。
  • 状态通知：通过托盘图标的变化实时提示 Hub 异常或拦截行为。

Streamable HTTP 合规 ​

MCP Hub 遵循 MCP Streamable HTTP 规范（2025-03-26 版本）：

  • 统一端点：/mcp 支持 POST、GET、DELETE 操作
  • Session 管理：通过 MCP-Session-Id Header 管理会话
  • Origin 验证：防止跨站请求伪造
  • 向后兼容：同时支持 /sse 和 /message 传统端点

下一步 ​

  • Skills Hub - 了解 Skills 的统一管理（与 MCP Hub 对称设计）
  • 项目管理 - 了解如何在项目中关联 MCP 服务
  • 快捷键 - 学习如何快速切换调试模式