使用说明

项目简介
- 该仓库实现了一个完整的 MCP 服务端，用于向 MCP 客户端提供统一的上下文信息和功能，包括资源管理、工具注册与执行、以及与 AOG 后端的对接能力。核心组件基于 MCP 服务器框架，提供 Tool Schema、Tool Handler、以及与 AOG 后端的交互逻辑，支持将本地引擎与插件无缝接入，形成一个可扩展的后端服务平台。
主要功能点
- MCP 核心功能实现
  - 处理基于 MCP 的请求与响应，注册各类工具（Tools），并提供工具执行结果的统一封装。
  - 支持对外暴露的工具包括服务、服务提供商、模型、以及云/本地推理等能力的查询和操作。
- MCP 服务端运行与对接
  - 服务器端在启动前会尝试与 AOG 服务进行健康检查，确保后端服务可用。
  - 通过 AOG 的 REST API 获取模型、服务与提供商信息，并将其暴露为 MCP Tool 的响应结果。
- 插件化能力
  - 内置插件注册与插件驱动器，能够在运行时加载基于插件的 API 风格与转换管道，扩展对外提供的能力。
- 多种传输支持与扩展性
  - MCP 服务器端设计支持多种传输协议（如标准输入输出、SSE、WebSocket 等），通过底层 MCP SDK 实现传输适配。
- 结构完整性
  - 包含完整的服务注册、工具执行、以及与 AOG 服务交互的实现逻辑，非单纯示例或测试。
安装与运行步骤
- 依赖与构建
  - 需要 Go 语言环境，执行 go build 生成 aog-mcp-server 二进制。
- 运行方式
  - 以命令行方式启动：./aog-mcp-server 或通过仓库提供的 CLI（aog-mcp-server）执行启动。启动时可以通过参数指定后端 AOG 的地址与超时等配置。
- 基本示例
  - 启动后，MCP 客户端即可通过配置的服务器端点访问已注册的 Tool。工具执行结果会返回 MCP 规范的输出内容，或错误信息。
服务器配置（MCP 客户端需要的配置信息）以下为建议的 MCP 客户端连接配置信息（JSON 格式）。该配置用于描述 MCP 服务器的名称、执行命令及参数，用于 MCP 客户端在启动阶段建立连接： { "server_name": "aog-mcp-server", "command": "./aog-mcp-server", "args": [ "--base-url", "http://localhost:16688", "--timeout", "120000" ] } 说明:
- server_name：MCP 服务器的名称，用于标识与管理。
- command：服务器端可执行文件的路径（不包含代码片段，方便直接在客户端读取并执行）。
- args：启动参数，包含与后端 AOG 服务交互所需的地址与超时等设置。
- 备注：MCP 客户端本身通常不需要在应用层直接处理服务器的实现细节，仅需指向正确的服务器可执行路径和启动参数，确保 MCP 服务能够被调用与管理。
基本使用方法
- 启动服务器
  - 在兼容的运行环境中执行服务器二进制，确保后端 AOG 服务可用，以便 MCP 服务器完成健康自检并注册提供的 Tool。
- 与 MCP 客户端对接
  - 使用上面给出的 JSON 配置，MCP 客户端即可通过 MCP 协议向服务器发起请求（如获取模型、调用工具、执行 Chat/GPT 风格 API 等），服务器将返回标准的 JSON-RPC 风格响应。
- 运行与扩展
  - 服务器代码已经实现了插件加载、工具注册与工具执行的核心流程，便于后续接入更多外部引擎或自定义工具。
- 部署注意
  - 确保与 AOG 的网络通信正常，必要时可在服务器启动时调整 baseURL、超时等参数以适配具体环境。
注意事项
- MCP 客户端与服务器之间的通信需要一致的工具定义与输入输出结构，请在客户端侧参考工具定义（GetServices、GetModels、Chat、TextToImage、Embed、SpeechToText 等 Tool），确保传入参数与服务端期望的一致。
- 插件与 API Flavor 的扩展需要与插件注册、模板转换管线协同工作，确保在生产环境中插件加载路径可用且可以正确解析插件 Manifest。

关键词

信息