← 返回项目库

mcp-agent — 基于 MCP 的智能体构建框架（中文版）

mcp-agent 是一个简单、可组合的 AI 智能体构建框架，基于模型上下文协议（MCP）实现。

mcp-agent 将 MCP 服务器连接管理与《Building Effective Agents》中的可组合模式整合到一个框架中，提供并行、路由、编排、Swarm、评估-优化、意图分类等多种工作流，并内置多模型支持与人工输入等能力。

真实界面

项目截图

共 6 张

基础智能体聊天机器人
检索增强生成聊天机器人
工作流路由示例
并行工作流示例
编排工作者工作流示例
多智能体集群工作流示例

Capabilities

核心功能

✓基于 MCP 的多服务器连接与生命周期管理
✓可组合工作流：并行、路由、编排、Swarm、评估-优化、意图分类
✓内置多模型支持：Anthropic、OpenAI、Azure、Bedrock、Cohere
✓支持人工输入与外部信号，可暂停工作流等待反馈
✓集成日志、事件传输与追踪等可观测性能力
✓同时提供命令行入口（mcp-agent）与 Python API 两种使用方式

适用场景

构建可复用工具调用的智能体应用
将 mcp-agent 应用作为 MCP 服务器对外暴露，实现服务器之服务器
实现多智能体编排、路由与任务并行处理

适合谁

面向希望基于 MCP 快速构建 AI 智能体的 Python 开发者、AI 工程师与技术团队。

商业化思路

本项目为开源软件，采用 Apache 2.0 许可证，供社区自由使用、修改与分发。

你会拿到什么

  • ✓Python 源码包及可执行 CLI 入口（mcp-agent 等别名）
  • ✓中文说明文档 README_zh-CN.md 与多个示例应用

部署流程

  1. 1使用 pip 或 uv 安装项目并安装依赖
  2. 2配置 MCP 服务器与模型提供商密钥后运行智能体或示例应用

真实验证结果

本地确定性运行证据已覆盖六个中文示例页面；外部模型与 MCP 服务依赖按已知问题披露。

部署前须知

部分示例依赖外部模型 API 密钥与本地服务（如 Qdrant），需用户自行配置。

部署难度

中等

最低配置

Python 3.10 及以上版本，支持 macOS、Linux 与 Windows 等主流操作系统。

开源许可证

Apache License 2.0

最后验证

2026-09-04

技术栈

PythonMCPFastAPITyperPydanticRich

授权说明

项目遵循上游 Apache 2.0 开源许可，本中文版未改变上游许可边界。

Release notes

版本记录

1 个已发布版本

v0.0.14-cn.1444 当前推荐

中文版本地化：将示例 UI 与演示数据翻译为简体中文，并新增中文说明文档；未改变上游功能与许可边界。

部署要求：需要 Python 3.10 或更高版本，并安装 fastapi、pydantic、mcp、rich、typer 等依赖。

已知问题：部分工作流示例的输出依赖外部大语言模型服务，结果可能存在不确定性。

登录后领取