MCP 服务器

Agent Construct

一个 MCP 服务器实现，它标准化了 AI 应用程序访问工具和上下文的方式，提供一个中央枢纽，通过简化的配置系统来管理工具发现、执行和上下文管理。

README

Agent Construct

“我们可以加载任何东西，从服装到设备，武器，训练模拟，任何我们需要的东西。” - 黑客帝国 (1999)

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

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

核心功能

MCP 协议实现

完全 MCP 兼容: 完整实现模型上下文协议规范
工具发现: 动态工具注册和发现机制
标准化通信: 实现 MCP 的工具交互通信模式

服务器架构

FastAPI 后端: 高性能异步服务器实现
事件流: 通过服务器发送事件 (SSE) 进行实时更新
模块化设计: 核心协议处理和工具实现之间的清晰分离
处理程序系统: 用于不同 MCP 操作的可扩展请求处理程序架构
基于工具的速率限制: 让服务器处理您可配置的每个工具的速率限制。

开发功能

工具装饰器系统: 通过 MCP 公开新工具的简单方法
日志记录和监控: 用于调试和监控的综合日志记录系统
配置管理: 具有安全默认值的基于环境的配置
测试框架: 用于协议合规性的广泛测试套件
Agent 框架友好: 包含用于自定义客户端或 smolagents 等框架的实现示例。

快速开始

前提条件

Python 3.8 或更高版本
pip 包管理器

安装

克隆存储库:

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

安装依赖项:
```
pip install -r requirements.txt
```

设置环境变量: 在根目录中创建一个 .env 文件，其中包含以下变量：

# 服务器配置
SERVER_HOST=localhost
SERVER_PORT=8000

# MCP 协议设置
MCP_VERSION=1.0
TOOL_DISCOVERY_ENABLED=true

# 安全设置
ENABLE_AUTH=false  # 生产环境启用

运行服务器:
```
python -m mcp_server
```

核心架构

mcp_server/
├── core/               # 核心 MCP 协议实现
│   ├── server.py      # 主要服务器实现
│   ├── protocol.py    # MCP 协议处理程序
│   └── context.py     # 上下文管理
├── handlers/          # MCP 操作处理程序
│   ├── discovery.py   # 工具发现
│   ├── execution.py   # 工具执行
│   └── context.py     # 上下文操作
├── utils/            # 实用函数
│   ├── logging.py    # 日志记录配置
│   ├── security.py   # 安全实用程序
│   └── config.py     # 配置管理
└── __main__.py       # 服务器入口点