Helicone MCP 服务器

关键词

LLM 上下文服务JSON-RPC工具注册资源管理自托管

使用说明（Markdown格式）

项目简介

  • 这是一个基于 MCP（Model Context Protocol）的服务器端实现，用于对接 LLM 客户端，向其暴露资源、工具和提示等能力。当前实现包含若干 MCP 工具（工具注册与执行的核心能力），通过 JSON-RPC 风格的通信，与客户端交互。

主要功能点

  • MCP 核心能力：实现 MCP 服务端，注册并暴露工具，响应客户端请求，提供会话/能力声明等基础能力。
  • 工具注册与实现：在服务器端注册了若干工具（例如 query_requests、query_sessions、use_ai_gateway），允许 LLM 客户端通过 MCP 调用外部数据源与外部服务。
  • 数据获取与聚合：通过 Helicone API 客户端实现对请求、会话以及 AI Gateway 的数据查询能力，返回统一格式内容给客户端。
  • 传输方式：使用 Stdio 传输作为 MCP 服务的运行方式，简化本地开发与测试环境。

安装步骤

  • 克隆仓库，安装依赖（如 Node.js/TypeScript 运行环境，以及 MCP 相关依赖）。
  • 构建/编译 MCP 服务器代码（将 TypeScript 编译为可执行的 JavaScript，生成 dist 目录）。
  • 以标准输入输出模式启动服务器；在终端执行相应命令后，服务器将通过 Stdio 传输与 MCP 客户端通信。

服务器配置（JSON 配置示例，客户端无需了解，仅供 MCP 客户端在连接时使用） { "server_name": "Helicone MCP", "description": "Helicone 提供的 MCP 后端服务器，暴露查询请求、查询会话和 AI Gateway 调用等工具.", "command": ["node"], "args": ["dist/helicone-mcp/src/index.js"], // 构建产物路径，按实际构建输出调整 "transport": "stdio", "version": "1.0.0" } 说明

  • server_name：服务器名称，便于客户端识别。
  • command/args：启动服务器的命令及参数，示例中假设通过 Node 运行编译产物 dist/helicone-mcp/src/index.js。
  • transport：传输方式，此实现使用 Stdio 传输（STDIN/STDOUT），这是 MCP 服务器常用的本地运行模式之一。
  • 注：MCP 客户端在连接时通常不需要额外的配置信，只需在调用端指定服务器信息即可；此处提供的 JSON 仅用于描述服务器启动与运行参数，真实部署中请按实际构建产物路径调整。

基本使用方法

  • 启动：在具备运行环境的服务器上，执行上述配置对应的启动命令，服务器启动后将通过 STDIO 与 MCP 客户端通信。
  • 调用方式：客户端通过 MCP 的 JSON-RPC 方式请求工具（如 query_requests、query_sessions、use_ai_gateway），服务器按请求参数进行处理并返回结果。
  • 监控与调试：查看控制台输出，关注注册的工具名称、请求参数以及返回内容；如遇异常，请检查 Helicone API 客户端的网络访问、鉴权以及环境变量设置。

注意事项

  • 当前实现使用的传输为 Stdio，适合本地开发与测试环境；若要在 WebSocket/SSE/HTTP 等环境部署，请在后续实现中接入对应传输层。
  • 由于 MCP 是一个协议与调用模型，务必确保客户端使用的 JSON-RPC 请求格式与服务器端工具注册信息一致。

关键词 LLM 上下文服务, JSON-RPC, 工具注册, 资源管理, 自托管

分类ID 6

服务器信息

访问项目