ForgeSyte Vision MCP 服务器

关键词

Model Context ProtocolJSON-RPCFastAPI插件化架构Gemini-CLI

使用说明内容（Markdown格式）

  • 项目简介 ForgeSyte 是一个模块化的 AI-vision MCP 服务器实现，核心目标是以标准化的方式向大模型客户端提供上下文信息和功能。通过 MCP 端点提供资源（数据访问）、注册与执行工具（外部功能调用）、以及定义/渲染 Prompt 模板，使用 JSON-RPC 与客户端通信。服务器端负责会话管理、能力声明，并对外暴露 MCP 清单和工具描述，支持通过 HTTP、WebSocket 等传输协议与客户端交互。

  • 主要功能点

    • MCP 具备的核心能力：以 MCP 规范暴露工具（Tools）、资源（Resources）和服务器能力信息；提供 MCPManifest，用于客户端发现与协商。
    • JSON-RPC 传输：通过 MCPTransport/JSON-RPC 结构处理请求与响应，支持初始化、工具列表、工具调用、资源读取/列举、心跳等。
    • 插件化架构：通过 PluginRegistry 实现插件的加载、管理、暴露工具。工具元数据通过 MCPTool 等模型暴露，支持 JSON 序列化。
    • 会话与健康管理：提供会话生命周期、错误处理、插件热加载、健康检查等能力，便于大规模部署与观测。
    • 多传输能力的设计：实现了针对 MCP 的 HTTP 传输路径（以及潜在的 WebSocket/流式交互设计），以便后续扩展。

  • 安装步骤

    1. 确保运行环境：Python 3.10+、uvicorn/uv、FastAPI、以及所需依赖。
    2. 获取代码：将代码克隆到本地并进入 server 目录。
    3. 安装依赖并启动服务器（快速启动示例）：
      • 使用 uv 工具链同步依赖并启动 FastAPI 服务，默认 API 端口为 http://localhost:8000。
      • 可以在需要时使用 Gemini-CLI 进行集成扩展，或通过浏览器访问 MCP Manifest 端点。
    4. 验证 MCP 服务能否暴露清单：
      • 访问 http://localhost:8000/v1/mcp-manifest 查看 MCP 服务清单。
      • 访问 http://localhost:8000/.well-known/mcp-manifest 进行标准发现。
    5. 如需浏览前端 UI，可在 web-ui 目录下安装并启动（可选）。

  • 服务器配置（给 MCP 客户端的配置信息，按客户端需要提供的字段说明）

    • serverName: ForgeSyte
    • command: ["uv","run","fastapi","dev","app/main.py"]
    • args: { "host": "0.0.0.0", "port": 8000, "reload": false } 注释说明：
    • serverName 指定 MCP 服务标识，便于客户端识别与对账。
    • command 为启动服务器的完整命令，客户端在建立 MCP 连接前须确认服务器已就绪。
    • args 给出服务器启动时的参数，包含监听地址、端口以及是否启用热重载等选项，便于在部署环境中复现。

  • 基本使用方法

    • 启动与发现：启动 ForgeSyte 服务器后，使用 MCP 客户端（如 Gemini-CLI 等）配置 MCP 服务器信息，检测服务器健康与可用工具。
    • 资源、工具与提示：服务器提供资源/工具/提示模板的标准描述，客户端通过 MCP 请求读取资源、调度工具执行、获取 Prompts 以引导对话。
    • 会话与能力声明：服务器在启动阶段声明能力，支持多插件加载和版本协商，确保与不同版本的 MCP 客户端互操作。
    • 运行与扩展性：模块化插件架构允许加载自定义 Vision 插件，扩展新的工具和资源类型，提升系统可扩展性。

  • 备注

    • 本仓库内包含完整的 MCP 服务实现模块，包括 MCPTransport、MCPAdapter、MCPProtocolHandlers、以及路由、路由中继等组件，且有与 Gemini-CLI 集成的扩展能力示例。
    • 若需要进一步与 Gemini-CLI 的扩展集成，请参考 README 和相应的 Gemini Extension 说明。

服务器信息

访问项目