Koryphaios MCP后端服务器
使用说明(Markdown格式):
-
项目简介
- Koryphaios 是一个面向多代理AI工作流的后端系统,核心提供对资源、工具、提示模板的集中管理,并通过 MCP 兼容的接口向 LLM 客户端提供上下文与能力。服务器端实现会话管理、工具执行、资源访问和提示渲染等核心功能,并支持通过不同传输协议(如标准I/O、SSE、WebSocket)与客户端进行通信。
-
主要功能点
- MCP核心能力:托管 Resources(资源/数据访问)、注册与执行 Tools(外部功能调用)、定义与渲染 Prompts(Prompt 模板)。
- JSON-RPC风格通信:通过标准化的JSON-RPC请求与响应进行交互,支持读取资源、调用工具、获取Prompt等。
- 会话与能力声明:对会话状态、参与者能力进行管理与暴露。
- 多传输协议支持:提供 StdIO、SSE、WebSocket 等传输方式的上下文服务。
- 安全与可扩展:内置认证、权限、插件/ MCP 服务端集成,支持添加外部 MCP 服务器。
- Tool 与 MCP 的集成:内置工具、外部 MCP 服务器的工具扩展能力。
-
安装步骤
- 安装运行时:推荐使用 Bun 1.0+ 作为运行时与包管理器。
- 获取代码:将仓库克隆下来并进入根目录。
- 安装依赖:在仓库根目录执行 bun install(或根据工作区配置安装各工作区依赖)。
- 环境变量与密钥:根据需要配置环境变量,如用于鉴权、密钥管理的密钥及机密信息。
- 启动后端与 MCP 服务:启动后端服务(backend),并确保 MCP 服务(若有)可通过 koryphaios.json 中的 mcpServers 配置项正确注册。
-
服务器配置(MCP客户端对接 MCP服务器的示例配置,JSON格式,含 server 名称、command、args 等注释性说明) 以下配置示例用于 MCP 客户端对接 MCP 服务器的连接信息,客户端需要在启动时读取此配置来与 MCP 服务器建立连接。请将“/path/to/mcp/fs”替换为实际的 MCP 服务执行路径或命令,以及根据实际环境调整 host/port。 { "server": { "name": "filesystem", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/mcp/fs"] } // 还可以按需添加其他 MCP 服务,例如: // "server": { ... }, } 说明:
- server.name: MCP服务器在客户端侧的标识名称,便于区分不同的 MCP 服务。
- command: 启动 MCP 服务的命令,通常是一个可执行 MCP 服务器的二进制或脚本。
- args: 启动命令的参数,例如 MCP 服务的包名、路径等。
-
基本使用方法
- 启动后端:在支持的环境中运行后端服务,确保服务端口对外可访问。
- 启动 MCP 服务:按需要在服务器上启动 MCP 子服务(如文件系统、工具集合等 MCP 服务),并确保其输出可被后端正确加载与管理。
- LLM 客户端接入:MC P客户端通过 JSON-RPC 调用后端的资源、工具、Prompts 接口,实现统一的上下文服务。
-
额外说明
- MCP功能是为 LLM 客户端提供结构化上下文及能力的后端能力,本仓库的后端实现包含资源、工具、提示模板的注册与渲染能力,以及与 MCP 服务器的对接逻辑。
- 客户端配置无需实现,只需在 MCP 客户端侧正确指定 MCP 服务器命令及参数,即可与 MCP 服务器建立连接并进行上下文服务交互。