XHelio MCP Server

关键词

JSON-RPC数据查询工具执行图像输出会话管理

使用说明（Markdown 格式）

  • 项目简介

    • XHelio MCP 服务器是一个基于 MCP 协议的后端服务，封装并暴露 XHelio 的对话和数据处理能力为 MCP 工具，客户端可通过 MCP 请求向服务器提交自然语言任务，服务器内部通过 OrchestratorAgent 进行任务分解、执行和结果返回，并可导出图形输出等。

  • 主要功能点

    • MCP 服务端核心：实现 MCP 工具的暴露与调用，处理来自 MCP 客户端的请求并返回对应的 JSON-RPC 响应
    • 资源与工具的间接整合：通过后端的数据查询、数据处理、绘图等能力，为 LLM 客户端提供上下文信息与外部功能
    • 图像输出支持：在任务产出时可返回 PNG/JPEG 等图像资源（如 Plotly/Matplotlib 输出）给客户端使用
    • 会话与状态管理：与本地会话、模型配置、以及任务执行状态等整合，提供会话级别的上下文管理
    • 多传输通道兼容性：设计目标支持如 Stdio、SSE、WebSocket 等传输协议的扩展场景

  • 安装步骤

    • 在 Python 环境中安装并进入开发模式（已提供的入口脚本支持本地执行与调试）
    • 运行前置依赖、环境变量配置（如 API key、模型等）准备就绪
    • 启动 MCP 服务器：直接执行 mcp_server.py 即可在默认端口监听 MCP 请求
    • 服务器启动后，客户端即可通过 MCP 客户端对接，发起 chat、get_status、reset_session 等操作

  • 服务器配置（MCP 客户端所需的连接信息，JSON 格式，供 MCP 客户端参考；注意 MCP 客户端本身不需要额外代码） { "server_name": "xhelio-mcp-backend", "command": "python", "args": ["mcp_server.py", "--verbose"], // 启用详细日志以便排错 "transport": "stdio", // 传输通道类型（示例，实际实现可扩展为 stdio/SSE/WebSocket 等） "host": "localhost", "port": 8000, // 若 MCP 服务器以网络方式暴露，则填写端口 "notes": "MCP 客户端通过 JSON-RPC 调用服务器暴露的聊天工具(chat)、会话管理接口(reset_session/get_status) 等。" }

  • 基本使用方法

    • 连接与请求：MCP 客户端通过 JSON-RPC 将 chat 请求发送给服务器，服务器返回对应的文本结果与可选的输出资源
    • 会话管理：使用 reset_session/get_status 进行会话重置与状态查询
    • 输出处理：如返回图像输出，客户端应处理图像数据（PNG/JPEG 等）并在需要时展示或保存

  • 注意事项

    • 服务器端需要正确的运行环境与依赖，且需要在客户端和服务端之间约定一致的 MCP 调用规范
    • 如要通过网络传输，请确保端口暴露与防火墙配置正确，必要时可结合 TLS/认证增强安全性

服务器信息

访问项目