AIInbx MCP 服务器

使用说明

• 项目简介
  • 该仓库实现了一个基于 MCP 的服务器端，核心职责包括托管和管理资源、注册和执行工具、以及定义与渲染提示模板。服务器通过 JSON-RPC 与 MCP 客户端协同工作，能够对外暴露工具、资源与提示，支持会话管理与能力声明，并可通过多种传输协议进行通信。
• 主要功能点
  • MCP 服务核心：实现 MCP 服务器端框架，处理来自客户端的请求并返回规范的 JSON-RPC 响应。
  • 资源、工具与提示：内置工具包括代码执行工具（本地或远端沙箱执行）和文档搜索工具；支持注册、调用和结果渲染。
  • 传输协议支持：支持标准输入输出（stdio）以及基于 HTTP 的流式传输等多种传输方式，用以适配不同运行环境。
  • 鉴权与日志：提供基于请求头的鉴权支持（API Key 形式），并具备可配置的日志系统。
  • 配置与扩展性：提供选项化配置，允许开启/关闭特定工具、选择代码执行模式、设置日志级别等，以适配不同场景。
• 安装步骤
  • 将仓库克隆到本地或服务器环境。
  • 运行依赖安装，确保 Node/TypeScript 环境就绪，并安装所需依赖。
  • 按需配置传输方式（stdio 或 http）及工具集（默认包含代码执行工具和文档检索工具）。
• 服务器配置
  • MCP 客户端在连接 MCP 服务器时需要提供以下 JSON 配置项以启动连接（示例配置，供参考，不涉及具体代码实现）： { "server": { "name": "aiinbx_api", "command": "npx", "args": ["aiinbx-mcp"] }, "transport": "stdio", "notes": "如需 API Key，请通过环境变量注入，例如 AI_INBX_API_KEY。服务器在启动时会暴露工具列表，客户端可通过 ListTools 请求获取工具信息，并通过 CallTool 调用具体工具。" }
  • 该配置中 server.name 对应 MCP 服务器的标识，command 与 args 指定启动服务的可执行命令与参数。具体环境变量和运行路径请结合实际部署环境配置。
• 基本使用方法
  • 启动服务器后，MCP 客户端可通过 JSON-RPC 向服务器发送请求，获取可用工具、执行工具、以及获取资源与提示模板等。
  • 客户端可以使用 CallTool 请求执行工具，传入对工具的参数；服务器将执行并返回 ToolCallResult（文本、图片、音频、资源等内容块形式的结果）。
  • 如需本地测试，可使用 stdio 传输方式在命令行级别启动，并通过标准输入输出与 MCP 客户端交互。