代理构造

“我们可以装载任何东西，从服装到装备、武器、训练模拟，任何我们需要的东西。”——《黑客帝国》（1999）

Agent Construct 是一种模型上下文协议 (MCP) 服务器实现，它标准化了 AI 应用程序访问工具和上下文的方式。正如《黑客帝国》中的 Construct 为操作员提供了对所需任何设备的即时访问一样，Agent Construct 也为 AI 模型提供了一个标准化接口，使其能够通过 MCP 规范访问工具和数据。

它基于模型上下文协议 (MCP)规范构建，充当 AI 应用的工具发现、执行和上下文管理的中央枢纽。它提供了一种强大且可扩展的方式，通过标准化协议向 AI 模型开放功能。此外，它还提供了简化的配置和工具结构，使添加新功能变得轻而易举！其中包含一个使用 Gemini 进行网页搜索的示例工具。

核心功能

MCP 协议实现

• 完全符合 MCP 规范：完全实现模型上下文协议规范

• 工具发现：动态工具注册和发现机制

• 标准化通信：实现 MCP 的工具交互通信模式

服务器架构

• FastAPI Backend ：高性能异步服务器实现

• 事件流：通过服务器发送事件（SSE）进行实时更新

• 模块化设计：核心协议处理和工具实现之间的明确分离

• 处理程序系统：针对不同 MCP 操作的可扩展请求处理程序架构

• 基于工具的速率限制：让服务器处理可配置的每个工具速率限制。

开发特性

• 工具装饰系统：通过 MCP 展示新工具的简单方法

• 日志记录和监控：用于调试和监控的综合日志系统

• 配置管理：基于环境的配置，具有安全默认值

• 测试框架：广泛的协议合规性测试套件

• 代理框架友好：包括自定义客户端或框架（如 smolagents）的实现示例。

Related MCP server: AgentMode

入门

先决条件

• Python 3.8 或更高版本

• pip 包管理器

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/agent-construct.git
   cd agent-construct

2. 安装依赖项：

   pip install -r requirements.txt

3. 设置环境变量：在根目录中创建一个.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

4. 运行服务器：

   python -m mcp_server

核心架构

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

• 本项目使用的各种工具和库的开源社区

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers