代理构造
“我们可以装载任何东西，从服装到装备、武器、训练模拟，任何我们需要的东西。”——《黑客帝国》（1999）
Agent Construct 是一种模型上下文协议 (MCP) 服务器实现，它标准化了 AI 应用程序访问工具和上下文的方式。正如《黑客帝国》中的 Construct 为操作员提供了对所需任何设备的即时访问一样，Agent Construct 也为 AI 模型提供了一个标准化接口，使其能够通过 MCP 规范访问工具和数据。
它基于模型上下文协议 (MCP)规范构建，充当 AI 应用的工具发现、执行和上下文管理的中央枢纽。它提供了一种强大且可扩展的方式，通过标准化协议向 AI 模型开放功能。此外，它还提供了简化的配置和工具结构，使添加新功能变得轻而易举！其中包含一个使用 Gemini 进行网页搜索的示例工具。
核心功能
MCP 协议实现
- 完全符合 MCP 规范：完全实现模型上下文协议规范
- 工具发现：动态工具注册和发现机制
- 标准化通信：实现 MCP 的工具交互通信模式
服务器架构
- FastAPI Backend ：高性能异步服务器实现
- 事件流：通过服务器发送事件（SSE）进行实时更新
- 模块化设计：核心协议处理和工具实现之间的明确分离
- 处理程序系统：针对不同 MCP 操作的可扩展请求处理程序架构
- 基于工具的速率限制：让服务器处理可配置的每个工具速率限制。
开发特性
- 工具装饰系统：通过 MCP 展示新工具的简单方法
- 日志记录和监控：用于调试和监控的综合日志系统
- 配置管理：基于环境的配置，具有安全默认值
- 测试框架：广泛的协议合规性测试套件
- 代理框架友好：包括自定义客户端或框架（如 smolagents）的实现示例。
入门
先决条件
安装
- 克隆存储库：
git clone https://github.com/yourusername/agent-construct.git
cd agent-construct
- 安装依赖项：
pip install -r requirements.txt
- 设置环境变量：在根目录中创建一个
.env文件，其中包含以下变量：# Server Configuration
SERVER_HOST=localhost
SERVER_PORT=8000
# MCP Protocol Settings
MCP_VERSION=1.0
TOOL_DISCOVERY_ENABLED=true
# Security Settings
ENABLE_AUTH=false # Enable for production
- 运行服务器：
核心架构
mcp_server/
├── core/ # Core MCP protocol implementation
│ ├── server.py # Main server implementation
│ ├── protocol.py # MCP protocol handlers
│ └── context.py # Context management
├── handlers/ # MCP operation handlers
│ ├── discovery.py # Tool discovery
│ ├── execution.py # Tool execution
│ └── context.py # Context operations
├── utils/ # Utility functions
│ ├── logging.py # Logging configuration
│ ├── security.py # Security utilities
│ └── config.py # Configuration management
└── __main__.py # Server entry point
MCP 协议功能
工具发现
- 动态工具注册系统
- 工具能力广告
- 版本管理
- 工具元数据和文档
上下文管理
- 高效的上下文存储和检索
- 上下文范围和隔离
- 实时上下文更新
- 上下文持久性选项
沟通模式
- 同步请求/响应
- 服务器发送的更新事件
- 流式响应
- 错误处理和恢复
未来的增强功能
协议扩展
- [ ] 高级上下文管理功能
- [ ] 自定义协议扩展
- [ ] 协议处理程序的插件系统
安全
- [ ] 身份验证和授权
- [ ] 工具访问控制
- [-] 速率限制和配额管理
- [ ] 审计日志
- [ ] 端到端加密
表现
- [ ] 工具执行优化
- [ ] 上下文缓存
- [ ] 负载均衡
- [ ] 请求排队
- [ ] 资源管理
发展
- [ ] 交互式协议浏览器
- [ ] 工具开发SDK
- [ ] 协议合规性测试工具
- [ ] 性能监控仪表板
贡献
欢迎贡献代码！欢迎提交 Pull 请求。对于重大变更，请先提交一个 issue 来讨论您想要修改的内容。
执照
该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。
致谢
- 协议规范的模型上下文协议
- 优秀的 Web 框架 FastAPI
- 本项目使用的各种工具和库的开源社区