Antigravity MCP 服务器

关键词

资源管理工具执行JSON-RPC跨协议路由会话管理

使用说明（Markdown 格式）

一、项目简介

  • Antigravity MCP 服务器是 Antigravity-Manager 系统中用于向大语言模型客户端提供上下文服务的后端模块。它实现资源管理、工具执行、提示模板等核心能力，并通过标准化的 JSON-RPC 方式对外暴露接口。系统具备会话管理、能力声明、多协议适配和 Transport 层的可扩展性，旨在为 LLM 应用提供安全、可扩展的上下文服务框架。

二、主要功能点（概览）

  • 资源托管与访问（Resources）：集中管理可被 LLM 客户端访问的数据资源与数据访问能力。
  • 工具注册与执行（Tools）：注册可被 LLM 调用的工具，支持远程调用外部服务或执行自定义功能。
  • Prompt 模板定义与渲染（Prompts）：定义可定制的提示模板，支持不同互动模式与模板渲染。
  • JSON-RPC 通信：服务器通过 JSON-RPC 与客户端通信，接收读取资源、调用工具、获取 Prompts 的请求并返回标准化响应。
  • 会话管理与能力声明：对话会话生命周期管理，以及对服务能力的表达与维护。
  • 多传输协议与路由：支持多种传输与接入方式，方便在不同环境中部署与接入。
  • 跨协议模型路由与配额保护：根据账号类型、模型配额、实时状态等因素进行模型路由与资源调度，确保高可用和资源合理分配。
  • 安全性与稳定性：内置错误处理、限流、权限控制、日志和监控等机制，以确保 MCP 服务在复杂场景下的鲁棒性。

三、安装与运行（简要要点）

  • 构建与启动：请从源码编译并运行 MCP 服务器组件，通常与 Axum/OpenAPI 等后端服务在同一系统中部署，具体执行命令以构建产出的可执行文件为准。
  • 服务端口与入口：MCP 服务器通过标准的后端端点对外暴露，具体的 RPC、HTTP 或 SSE 入口地址请参考运行时日志或配置。
  • 依赖与集成：该 MCP 服务器与系统中的资源、工具、Prompts、模型路由等组件在同一个 repo 内集成，运行前请确保后端主服务正常启动并可对外访问。

四、服务器配置（面向 MCP 客户端的启动配置说明） 说明：MCP 客户端在连接 MCP 服务器时需要提供一个配置描述，至少包含服务器名称、启动命令及参数等信息，用于建立与 MCP 服务器的连接。以下为参考配置要点（以描述性文本形式呈现，非代码块）：

  • server_name：Antigravity MCP Server（用于标识不同 MCP 服务器的名称）
  • command：指向启动 MCP 服务器的可执行文件路径（示例描述：主后端服务可执行文件，例如 Antigravity-MCP Server 二进制），具体路径请按实际部署位置填写
  • args：启动参数数组，包含用于开启 MCP 功能、暴露 RPC 接口、指定数据目录、日志级别等的参数（具体参数请以实际运行时的启动选项为准，例如指定 API 基地址、RPC 端口、资源/工具/提示模板源等；若无特殊启动参数，可留空）
  • 说明：在本仓库中，MCP 服务通常与 Antigravity-Manager 的后端服务结合部署，启动方式与入口可能在工作流/脚本中被封装，客户端只需在启动后知晓服务器的名称与对接端点即可

五、基本使用方法（对 MCP 客户端友好）

  • 如何连接：通过 JSON-RPC 客户端向 MCP 服务器发起请求，读取资源、注册工具、获取提示模板等；服务器返回标准化的 JSON-RPC 响应或通知。
  • 如何使用资源、工具与 Prompts：
    • 读取 Resources：向 MCP 服务器发起资源查询请求，获取可用的数据与数据访问接口。
    • 调用 Tools：向 MCP 服务器注册的工具发起调用请求，服务器将路由到相应上游服务并返回结果。
    • 获取 Prompts：请求当前可用的 Prompt 模板，或获取渲染后的对话模板以规范化交互。
  • 许可与安全性：MCP 服务器实现通常包含会话管理与能力声明，请遵循项目的安全策略和访问控制要求，确保凭据与访问密钥的安全存储与使用。
  • 部署注意事项：如需在生产环境使用，请确保后端服务启动稳定、网络访问可达、并结合日志与监控对系统健康进行观察。

六、注意事项与扩展点

  • MCP 功能扩展性：仓库中已包含多种与 MCP 相关的实现组件（Resources、Tools、Prompts、Model Router、Signature Cache、Token 管理、监控等），可按需扩展新的模型、路由策略或新的工具适配器。
  • 安全性与合规性：鉴于 MCP 涉及跨模型与跨服务的能力调用，请关注权限、配额保护、签名与会话隔离等方面的实现与测试。
  • 部署方式多样性：支持桌面端（TAURI 前端）与服务端部署的混合场景，可结合现有代理/网关架构进行无缝对接。

七、运行与维护建议

  • 监控与日志：结合系统监控、日志聚合与调试工具，对 MCP 请求、工具调用、模型路由、配额状态等关键维度进行观测与记录，便于排错和性能优化。
  • 测试与回归：在更新 MCP 路由、模板、工具映射或模型配额策略后，进行端到端的功能测试，确保跨协议兼容性与稳定性。

备注：以上内容基于仓库中存在的 MCP 相关实现（如在 Axum 服务中对 /mcp/... 路径的暴露、以及多协议模型路由、工具适配、并发与会话管理等实现）进行综合判断，确定该仓库具备可运行的 MCP 服务器实现能力，且具备完整的服务器端功能与可部署性。

服务器信息

访问项目