Granzion MCP 服务器集成套件

关键词

模型上下文服务资源与工具管理上下文代理数据与工具集成面向LLM的后端服务

使用说明

  • 项目简介
    • Granzion MCP 服务器集成套件是一组实现 MCP 标准的后端服务，通过 JSON-RPC 与 LLM 客户端通信，托管资源、注册并执行工具、渲染并提供 Prompt 模板，支持会话管理与能力声明，且设计为可通过多传输协议（如 StdIO、SSE、WebSocket）进行扩展的后端服务框架。
  • 主要功能点
    • 资源管理（Resources）：提供数据访问与持久化能力，便于 LLM 客户端获取上下文所需的外部数据。
    • 工具注册与调用（Tools）：允许注册并执行外部功能，LLM 可以通过统一接口调用外部服务或任务。
    • 提示模板定义与渲染（Prompts）：集中管理 LLM 交互所需的模板化提示，支持可定制的交互模式。
    • MCP 服务器间协作：多种 MCP Server 实现（如 Identity、Memory、Data、Comms、Infra 等）可组合使用，统一数据层（PostgreSQL/向量数据库/图数据库）以支撑复杂场景。
    • JSON-RPC 协议通信：通过标准的 JSON-RPC 请求/响应进行交互，具备会话管理与能力声明能力。
    • 拓展性与安全性：身份优先设计、委托与权限体系、可扩展传输通道，面向 LLM 应用的上下文服务框架。
  • 安装步骤
    1. 安装依赖
      • 安装 Python 3.9+（或仓库要求的最低版本），并确保可执行环境具备网络访问权限。
      • 安装依赖（如有 requirements.txt 或 poetry/pipenv 配置，请按仓库提供的说明执行安装）。
    2. 获取代码
      • 将仓库克隆到本地或服务器环境中，进入项目根目录。
    3. 启动 MCP 服务器组件
      • 使用如下命令启动各个 MCP 服务器实例（示例，具体端口与参数以实际需求为准）：
        • Identity MCP：python3 -m src.mcps.identity_mcp --port 8002
        • Memory MCP：python3 -m src.mcps.memory_mcp --port 8003
        • Data MCP：python3 -m src.mcps.data_mcp --port 8004
        • Comms MCP：python3 -m src.mcps.comms_mcp --port 8005
        • Infra MCP：python3 -m src.mcps.infra_mcp --port 8006
      • 启动前请确保数据库、Keycloak、以及图/向量数据库等后端依赖服务就绪（如使用仓库自带的 Docker 版快速启动流程，请参考 QUICK START 指引）。
    4. 连接配置（MCP 客户端配置示例，非代码，仅作为说明） 下面给出 MCP 客户端连接 MCP 服务器的配置示例（JSON格式，不是实际代码，实际客户端配置请按你的代理/客户端实现进行对应调整）： { "server_name": "identity-mcp", "command": "python3", "args": ["-m", "src.mcps.identity_mcp", "--port", "8002"], "description": "Identity MCP 服务启动命令及参数" } { "server_name": "memory-mcp", "command": "python3", "args": ["-m", "src.mcps.memory_mcp", "--port", "8003"], "description": "Memory MCP 服务启动命令及参数" } { "server_name": "data-mcp", "command": "python3", "args": ["-m", "src.mcps.data_mcp", "--port", "8004"], "description": "Data MCP 服务启动命令及参数" } { "server_name": "comms-mcp", "command": "python3", "args": ["-m", "src.mcps.comms_mcp", "--port", "8005"], "description": "Comms MCP 服务启动命令及参数" } { "server_name": "infra-mcp", "command": "python3", "args": ["-m", "src.mcps.infra_mcp", "--port", "8006"], "description": "Infra MCP 服务启动命令及参数" }
      • 注释说明
        • 以上配置仅用于示意，实际 MCP 客户端实现时应以具体运行环境的入口点和参数为准。
  • 服务器配置与连接要点
    • MCP 服务器应对外暴露 JSON-RPC 接口，接受标准的请求格式并返回 JSON-RPC 格式的响应或通知。
    • 客户端通过配置将服务器启动命令及参数引导起来，与 MCP 服务器建立连接后即可通过约定的 RPC 调用完成资源读取、工具执行、以及提示渲染等操作。
    • 该仓库提供了 Identity、Memory、Data、Comms、Infra 等 MCP Server 实现，适合组合搭建完整的 MCP 后端前后端生态。
  • 基本使用方法
    • 启动并对接
      • 启动所需的 MCP 服务器实例（Identity/Memory/Data/Comms/Infra）并确保数据库等后端服务就绪。
      • 使用客户端配置的 JSON 配置，运行相应的 MCP 服务入口，以建立与 MCP 服务器的连接并实现资源、工具、提示的访问。
    • 典型应用
      • LLM 调用场景中，通过 MCP 服务器获取当前资源、调用工具、渲染提示模板，生成上下文丰富的对话与推理支撑。
    • 常见运维
      • 监控 MCP 服务器状态、查看日志、对接 Keycloak 等身份服务、确保数据库健康、及时应用更新。

服务器信息

访问项目