使用说明(Markdown 格式)如下:

  • 项目简介

    • 该项目实现了一个 MCP 服务器,允许 LLM 客户端通过 JSON-RPC 的方式访问和管理资源、注册和执行工具,以及渲染和使用提示模板,核心目标是为大语言模型提供可扩展的上下文服务框架。
  • 主要功能点

    • 资源管理:暴露并提供对资源的读取、显示和描述,帮助客户端获取上下文信息。
    • 工具注册与执行:实现一组工具,允许 LLM 调用外部接口完成任务(如 Lead、Campaign、Conversations 等相关操作)。
    • 提示模板:定义并渲染 Prompt 模板,支持给定参数后返回结构化的 prompts 内容。
    • 安全与可观测性:内置认证、错误处理、速率限制以及健康检查接口,支持生产化日志输出。
    • 多传输模式:支持 STDIO 与 HTTP 传输,便于本地开发、IDE 集成以及远程服务部署。
  • 安装步骤

    • 安装与环境准备:确保 Python 3.10 及以上环境,具备网络访问能力。
    • 克隆仓库并进入项目目录,安装依赖并激活虚拟环境(具体命令请参考仓库自带的启动脚本 start.sh / start-http.sh)。
    • 配置环境变量:创建并填写 .env 文件,包含 MULTILEAD_API_KEY、MULTILEAD_BASE_URL、MULTILEAD_TIMEOUT、MULTILEAD_DEBUG 等配置项(示例在仓库中提供 .env.example)。
  • 服务器配置(MCP 客户端需要的最小配置信息示例,JSON 格式,字段含义如下) { "server_name": "Multilead Open API MCP Server", "command": "python", "args": ["server.py", "--transport", "http", "--host", "0.0.0.0", "--port", "8000"] // 说明: // - server_name: 服务器名称,便于客户端显示与管理 // - command: 启动服务器的命令(不包含实际脚本路径) // - args: 启动参数,例如指定传输模式为 HTTP、监听地址与端口等 }

  • 基本使用方法

    • STDIO 模式:适用于本地 IDE 集成,如 Claude Desktop/Code,启动前配置好环境变量,运行 server.py。
    • HTTP 模式:适用于远程部署,使用 start-http.sh 启动,访问 MCP 端点进行交互。
    • 客户端交互通常通过 JSON-RPC 调用工具、读取资源、获取提示等来实现对后端服务的访问。
  • 注意事项

    • 请勿将含有敏感信息的配置文件提交到版本控制,重要凭据通过环境变量注入。
    • 根据实际使用场景调整日志、限流等生产参数,以达到稳定运行。

信息

分类

网页与API