Retell MCP 服务端

使用说明（Markdown 格式）

• 项目简介

  • 该仓库实现了一个基于 Model Context Protocol 的 MCP 服务器，用于向 LLM 客户端提供可管理的资源、可调用的工具，以及可渲染的 Prompt 模板，来支持复杂的对话与任务执行场景。服务器通过 JSON-RPC 与客户端通信，具备会话管理、能力宣告、以及多种传输协议的支持。

• 主要功能点

  • MCP 核心能力：托管和管理 资源（Resources），注册和执行 Tools，定义并渲染 Prompt 模板，向 LLM 客户端提供标准化的上下文信息和外部功能。
  • 接口与传输：通过 JSON-RPC 与客户端通信；支持 STDIO 与 HTTP（Streamable HTTP）两种传输模式，便于在本地或网络环境中部署。
  • 会话与权限：服务端负责会话管理、能力声明，提供日志与错误处理，支持对 API Key 的校验与头信息处理。
  • 安全与扩展性：在工具执行环节提供对代码执行的受控能力（例如代码工具 execute），并引入 docs-search 等工具以帮助 LLM 客户端进行自助式集成与文档检索。
  • 配置与自定义：提供可配置的工具集合、代码执行模式等，允许按需开启/关闭特定工具，以及设置日志级别、超时、重试策略等。

• 安装与运行步骤

  • 安装依赖：在本地环境中获取代码依赖（如 Node.js 运行时环境和包管理工具）。
  • 构建与打包：编译 TypeScript 代码以产出可运行的服务器入口。
  • 启动方式：
    • 以标准输入输出（stdio）方式运行，适合本地开发与调试。
    • 以 HTTP（Streamable HTTP）方式运行，便于远程客户端通过网络调用。
  • 配置要点：
    • 服务器端需要提供 Stainless API Key 的访问能力，客户端通过配置将连接信息发送给 MCP 服务器。
    • MCP 客户端连接需要的基本信息包括服务器名称、启动命令与参数等配置（见下方“服务器配置”部分的示例）。

• 服务器配置（给 MCP 客户端的启动配置，json 格式） 说明：以下信息用于 MCP 客户端在本地或远端启动并连接到 MCP 服务器。服务器名称与启动命令在代码中已实现默认值，具体信息如下：

  • serverName: retell_sdk_api
  • command: npx
  • args: ["-y", "@retell-ai/mcp-server"]
  • 备注：启动前请确保环境变量正确设置，如 STAINLESS_API_KEY、RETELL_API_KEY、RETELL_BASE_URL 等，以便 MCP 服务器能够正确访问对应的后端服务。 示例（文本描述，非代码块）： { "serverName": "retell_sdk_api", "command": "npx", "args": ["-y", "@retell-ai/mcp-server"] } 说明：上述配置仅用于帮助 MCP 客户端启动并连接到服务器，实际连接时还需要在运行环境中设置必要的环境变量与 API Key。

• 基本使用方法

  1. 启动 MCP 服务器（基于仓库实现，选择 STDIO 或 HTTP 传输方式）；
  2. 通过 MCP 客户端配置，提供服务器名称、启动命令及参数，让客户端启动并连接 MCP 服务器；
  3. MCP 服务器启动后，LLM 客户端即可通过 JSON-RPC 调用资源、工具或提示相关接口，获得规范化的响应；
  4. 如需自定义工具或 Docs 搜索等扩展工具，请按照服务器提供的工具集合进行调用配置；
  5. 运行中如遇到权限或连接问题，请检查 STAINLESS_API_KEY、RETELL_API_KEY 等环境变量以及网络访问权限。

• 备注

  • 本实现包含了核心服务端代码、工具执行逻辑、Docs 搜索工具、以及对外暴露的 MCP 服务入口。实际部署时应结合具体网络拓扑与安全策略进行配置与监控。