Agentic-MCP 服务器集合

关键词

模型上下文协议工具注册与执行资源管理JSON-RPC 通信跨传输协议

使用说明（简要版，便于快速搭建与理解）：

  • 项目简介

    • 该仓库包含若干基于 MCP 的后端服务器实现，主要用于向 LLM 客户端提供资源访问、工具执行、以及提示模板等能力，支持多种传输协议与会话能力。
    • 核心结构通常包含：MCP 服务器端实现、工具定义、端点暴露、以及与模型服务的对接逻辑。

  • 主要功能点

    • MCP 服务器：实现 MCP 的核心能力，包括列出可用工具、处理工具调用、以及在标准化格式下返回结果。
    • 工具注册与执行：服务器暴露可注册的工具，LLM 客户端可调用这些外部功能；服务器端负责执行、回传结果。
    • 资源与会话管理：支持资源的访问、记忆/历史的管理，以及会话上下文的维持。
    • 多传输协议支持：提供 STDIO 等传输模式的实现，方便与不同运行环境的客户端对接。
    • 安全与扩展性：通过初始化选项、内存保存等机制实现会话记忆和可扩展的工具集。

  • 安装步骤

      1. 确保 Python 环境就绪（Python 3.8+ 一般即可）。
      1. 安装所需依赖。仓库中包含的 MCP 服务器实现通常要求安装 mcp、fastmcp、以及与之相关的依赖库（具体请查看各 MCP 服务器目录下的 README/requirements.txt）。
      1. 启动 MCP 服务器。示例：
      • hubspot-mcp-server： 启动命令（示例，实际路径请按仓库结构执行）: python sdr_multi_agent/mcp_servers/hubspot_server/mcp_server.py 传输模式：stdio（服务器内部通过 stdio 与客户端中转）
      • research-mcp-server： 启动命令（示例，实际路径请按仓库结构执行）: python sdr_multi_agent/mcp_servers/research_server/mcp_server.py 传输模式：stdio（服务器内部通过 stdio 与客户端中转）
      1. 设置环境变量（如 API 密钥、外部服务的密钥等），确保服务器运行时能够访问所需外部服务。

  • 服务器配置（MCP 客户端需要的配置信息，示例 JSON，非代码片段） 说明：以下配置用于 MCP 客户端建立连接，含 server 名称、启动命令以及参数，便于在客户端进行管理与发现。MCP 客户端不需要此处的代码，只需按示例填充对应字段即可。

    • HubSpot MCP 服务器配置示例 { "server_name": "hubspot-mcp-server", "description": "HubSpot 联系人管理工具的 MCP 服务", "enabled": true, "command": "python3", "args": [ "sdr_multi_agent/mcp_servers/hubspot_server/mcp_server.py", "--transport", "stdio" ] }

    • Research MCP 服务器配置示例 { "server_name": "research-mcp-server", "description": "研究任务工具与网页抓取/检索的 MCP 服务", "enabled": true, "command": "python3", "args": [ "sdr_multi_agent/mcp_servers/research_server/mcp_server.py", "--transport", "stdio" ] }

    说明与要求

    • 上述配置仅用于示意，实际 MCP 客户端的配置应以仓库中各服务目录下的实际实现为准。
    • 配置中的 server_name、描述、启用状态等字段用于客户端管理与发现； command/args 则指向要启动的服务器脚本及初始参数。MCP 客户端在连接前无需依赖这些配置的实现逻辑，只需知道服务器地址、能提供的能力等元信息即可。

  • 基本使用方法

    • 启动 MCP 服务器后，客户端（LLM 客户端/代理）通过 MCP 协议向服务器发送请求，例如读取资源、调用工具、获取 Prompt 等。服务器返回标准化的 JSON-RPC 响应，或通过通知发送结果。
    • 使用场景包括：在代理/Agent 中通过工具实现对外部系统的操作、按需渲染 Prompt 模板，以及在会话中持续管理资源和工具能力。
    • 如需扩展：可在现有服务器基础上注册新工具、扩展资源、或自定义提示与渲染逻辑。

  • 注意事项

    • 运行环境中需确保外部服务密钥及网络访问权限正确配置（如 HubSpot、SerpAPI、Groq、Resend 等外部服务）。
    • MCP 服务器应合理配置传输协议、会话管理策略，以及工具执行的安全边界，确保对外接口的可控性与日志可追溯性。

服务器信息

访问项目