Qurio MCP Server Backend

关键词

模型提供者集成工具编排流式响应会话管理外部工具对接

使用说明（Markdown 格式）如下，帮助你快速理解与落地部署。

项目简介

Qurio 的后端服务器具备 MCP 相关能力，能够托管和管理资源（Resources）、注册并执行工具（Tools）、定义并渲染提示模板（Prompts），并通过标准化的 JSON-RPC 整合向 LLM 客户端提供上下文信息与功能。核心通过 MCP 管理器将外部 MCP 服务器的工具映射到 Qurio 的工具生态，支持多种传输协议（SSE、HTTP、WebSocket、Stdio）以及安全的会话管理。

主要功能点

  • MCP 服务器管理
    • 连接、断开外部 MCP 服务器
    • 加载服务器及其工具集合，统一转换为 Qurio 版本的工具表示
    • 针对不同服务器实现工具调用、工具执行与结果注入到对话中
  • 工具与资源编排
    • 将外部 MCP 工具分组与可视化控制（启用/禁用、分组、权限控制）
    • 提供本地化工具、HTTP 工具、以及 MCP 工具的对接能力
  • Prompts 与渲染
    • 支持针对不同提供者的模板化提示生成与渲染
    • 支持多模型提供者的路由（OpenAI、Gemini、SiliconFlow、GLM、ModelScope、Kimi、NVIDIA NIM、Minimax 等）
  • 流式/非流式响应
    • 支持 SSE、HTTP 流、以及标准 HTTP 响应，便于 LLM 客户端的实时体验
  • 后端服务与路由
    • 提供健康检查、工具查询、工具调用、深度研究工作流等 API 路由
    • MCP 工具统一管理接口，便于前端或其他服务接入
  • 安全与扩展
    • 会话管理、L2 访问控制、模型路由分发、思考/推理模式的配置等
    • 具备可扩展性以接入更多 MCP 服务器和多提供者模型

安装与运行

  • 该仓库包含 Express 后端服务入口，需在本地/服务器环境部署：
    • 安装 Node 依赖
    • 启动后端服务器（监听 3001 端口为默认）
  • 说明：MCP 服务器的启动通常涉及外部 MCP 服务的地址、传输模式等配置；Qurio 提供对接入口与管理接口，实际 MCP 服务进程需独立部署并可通过 Qurio 的管理接口加载。

服务器配置

以下为 MCP 客户端（需要连接的 MCP 服务器）的示例配置（请仅将本配置用于 MCP 客户端的连接信息展示，不作为服务器代码的实现）： { "serverName": "Qurio-MCP-Local", "command": "node", "args": ["backend/src/server.js", "--port=3001", "--host=0.0.0.0"] } 说明：

  • serverName: Qurio 的 MCP 服务器标识名称，唯一性用于 Qurio 进行绑定与管理。
  • command: 启动 MCP 服务器的命令，Qurio 客户端使用该信息确认应如何启动对应的 MCP 服务器。
  • args: 启动命令的参数列表，包含端口、绑定主机等，确保 MCP 服务器可被 Qurio 加载与连接。 注释说明：
  • MCP 客户端不需要本配置来实现自身功能，但该字段用于帮助部署脚本与运维快速对接外部 MCP 服务器。
  • 对接的 MCP 服务器应暴露访问接口 URL（如 HTTP/SSE），Qurio 的后端会通过该地址与 MCP 服务器进行工具查询和调用。

基本使用方法

  • 部署与加载外部 MCP 服务器：通过 Qurio admin/接口将外部 MCP 服务器的信息注册到 Qurio，Qurio 将加载并转换工具为内部表示，供后续对话中工具调用使用。
  • 管理工具与分组：在后端路由中可以查看、加载、卸载 MCP 服务器及其工具，以及查看全部工具清单。管理员可按需启用/禁用某些工具以限制 LLM 的外部调用权限。
  • 与 LLM 的交互：前端/客户端通过 MCP 相关 API 与 Qurio 进行交互，服务器会根据工具定义与上下文注入策略将工具调用结果注入对话中，支撑更强的可控性和可解释性。
  • 安全性与扩展性：后端提供健康检查、工具调用日志、错误处理与错误返回，便于诊断与扩展。

额外说明

  • 本实现包含后端服务器、MCP 工具管理、提供对外 MCP 服务的路由、以及对外提供工具以及工具执行结果的标准化接口，属于较为完整的 MCP 服务器实现范例，具备运行能力、功能明确性以及对 MCP 生态的扩展性。

服务器信息

访问项目