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 服务器建立连接并进行上下文服务交互。

服务器信息