AgentMCP 使用说明

项目简介

AgentMCP 是一个多智能体协作平台，它实现了模型上下文协议（MCP），旨在简化和标准化AI智能体之间的交互。通过 AgentMCP，开发者可以使用一个简单的装饰器 '@mcp_agent' 将任何智能体转换为 MCP 兼容的智能体，使其能够轻松加入多智能体协作网络（MACNet），与其他智能体协同工作。AgentMCP 支持多种AI框架，如 Langchain、CrewAI、Autogen 和 LangGraph，并提供了一套统一的协议和架构，用于智能体之间的通信、上下文共享和任务协调。

主要功能点

一键集成MCP: 通过 '@mcp_agent' 装饰器，只需一行代码即可将现有智能体接入 MCP 网络。
跨框架协作: 支持 Langchain, CrewAI, Autogen, LangGraph 等多种AI框架的智能体无缝协作。
自动网络注册: 智能体自动注册到 MACNet 网络，无需复杂配置。
工具发现与调用: 智能体可以发现和调用网络中其他智能体的功能（Tools）。
上下文管理: 提供共享上下文机制，允许智能体之间共享和访问信息。
灵活的架构: 采用协调器-工作者模式，基于 FastAPI 构建，支持异步处理和多种传输协议。

安装步骤

安装 AgentMCP 库:

pip install agent-mcp

服务器配置

AgentMCP 本身作为一个库，主要用于构建和运行 MCP 客户端（即各种AI智能体）。它本身不直接提供独立的 MCP 服务器启动命令和参数。

AgentMCP 客户端需要连接到一个 MCP 服务器才能加入 MACNet 网络。根据仓库信息，AgentMCP 默认连接到由 grupa-ai 托管的公共 MCP 服务器：'https://mcp-server-ixlfhxquwq-ew.a.run.app'。

配置信息 (JSON 格式，仅供参考，MCP客户端通常会自动处理连接):

{
  "server name": "AgentMCP Public Server",
  "command": "N/A",
  "args": [],
  "server_url": "https://mcp-server-ixlfhxquwq-ew.a.run.app",
  "description": "AgentMCP 默认公共 MCP 服务器，用于智能体网络协作。"
}

请注意： 用户通常不需要手动配置 MCP 服务器的启动命令和参数来使用 AgentMCP 客户端。AgentMCP 客户端库已经预配置了连接到默认公共服务器的设置。用户只需安装库并在其智能体类上使用 '@mcp_agent' 装饰器即可。

基本使用方法

导入 'mcp_agent' 装饰器:

from agent_mcp import mcp_agent

使用 '@mcp_agent' 装饰你的智能体类:

@mcp_agent(name="YourAgentName")
class YourAgent:
    # 你的智能体代码
    def your_method(self, input_data):
        # 智能体功能实现
        return "Your Agent Result"

注册工具 (可选): 使用 '@register_tool' 装饰器注册智能体的方法作为 MCP 工具，使其可以被其他智能体调用。

from agent_mcp import mcp_agent, register_tool

@mcp_agent(name="ToolAgent")
class ToolAgent:
    @register_tool(name="analyze_data", description="分析给定的数据")
    def analyze_data(self, data):
        return "数据分析结果"

运行你的智能体应用: 启动你的 Python 应用程序，被 '@mcp_agent' 装饰的智能体将自动连接到 MCP 网络并开始工作。

通过以上步骤，你的智能体就可以加入 AgentMCP 平台，与其他智能体进行协作，实现更复杂的AI应用场景。

关键词