lastmile-ai/mcp-agent
AI 要約 · Qwen 要約は中国語 収録日
原文を読む mcp-agent 是一个以 MCP 为核心、提供可组合 agent 模式、持久执行和云部署能力的 Python 框架。
项目定位
- mcp-agent 是一个用于构建基于 Model Context Protocol（MCP）的 agent 的简单、可组合框架。
- 其理念是 MCP 足以构建 agent，简单模式比复杂架构更适合交付高质量 agent。
核心能力
- 完整实现 MCP，并管理 MCP 服务器连接生命周期。
- 以可组合方式实现 Anthropic《Building Effective Agents》中的多种 agent 模式。
- 支持从简单 agent 扩展到基于 Temporal 的持久工作流，可暂停、恢复并在不改变 agent API 的情况下恢复。
安装与快速开始
- 推荐用 uv 管理项目，也可用 pip 安装 mcp-agent。
- CLI 可通过 uvx mcp-agent 初始化项目、管理 secrets、检查工作流并部署到 Cloud。
- 配置通常放在 mcp_agent.config.yaml，密钥放在 mcp_agent.secrets.yaml 或环境变量中。
核心组件
- MCPApp 负责加载配置、日志、追踪和执行引擎。
- Agent 与 AgentSpec 将指令、MCP 服务器和可选函数绑定。
- Augmented LLM 包装 LLM provider SDK，提供 generate、generate_str 和 generate_structured 等能力。
- 工作流装饰器可将协程转换为工具或持久工作流。
工作流模式
- 提供 parallel/map-reduce、router、intent classifier 等辅助函数。
- 提供 orchestrator-workers、deep research、evaluator-optimizer 和 swarm 等模式。
- 这些模式可作为可复用工作流组合，用于构建更高层 agent 应用。
生产与部署
- 支持 Temporal 作为执行后端，实现暂停/恢复、重试、人工输入和持久历史。
- 提供结构化日志、OpenTelemetry 和 TokenCounter 用于可观测性与 token 用量跟踪。
- 可将 MCPApp 暴露为标准 MCP server，供 Claude Desktop、Cursor 等客户端调用。
- 可部署到 mcp-agent Cloud，获得托管 Temporal 执行、secrets 和 HTTPS MCP 端点。
文档与生态
- 完整文档位于 docs.mcp-agent.com，并提供 llms.txt、llms-full.txt 和 docs MCP server。
- 仓库包含 examples 目录和 gallery.md，提供可运行示例与社区项目。
- 项目欢迎贡献，并可通过 Discord 参与讨论。