项目介绍

基于 aiohttp 的构建 Model Context Protocol (MCP) 服务器的工具。

功能

• 与 aiohttp Web 应用程序轻松集成
• 支持 Model Context Protocol (MCP) 工具
• 异步优先设计
• 型别提示支持
• 开发模式调试功能
• 灵活的路由选项

安装

使用 uv 包管理器：

uv add aiohttp-mcp

或使用 pip：

pip install aiohttp-mcp

快速上手

基本服务器设置

创建一个简单的 MCP 服务器和自定义工具：

import datetime
from zoneinfo import ZoneInfo

from aiohttp import web

from aiohttp_mcp import mcp

# 初始化 MCP 实例
mcp_instance = mcp.MCP()

# 定义路由处理器
async def handler(request):
    # 处理请求逻辑
    pass

# 创建 Web 应用程序
app = web.Application()
app.add_routes([web.get('/', handler)])

# 运行应用程序
if __name__ == '__main__':
    web.run_app(app)

子应用配置

将 MCP 集成到现有的 aiohttp 应用中：

import datetime
from zoneinfo import ZoneInfo

from aiohttp import web

from aiohttp_mcp import mcp

# 初始化 MCP 实例
mcp_instance = mcp.MCP()

# 创建子应用
sub_app = web.Application()
sub_app.add_routes([web.get('/sub', handler)])

# 创建主应用并将子应用注册为路由前缀 '/sub'
main_app = web.Application()
main_app.add_subapp('/sub', sub_app)

# 运行应用程序
if __name__ == '__main__':
    web.run_app(main_app)

开发指南

环境搭建

1. 安装依赖项：

pip install aiohttp aiohttp-sse anyio mcp

2. 克隆仓库：

git clone https://github.com/kulapard/aiohttp-mcp.git
cd aiohttp-mcp

代码开发

• 遵循 PEP8 和 Python 型别提示指南
• 提交前运行测试：

pytest tests/

代码提交

• 使用黑体格式化代码：

black .

• 检查型别提示：

mypy .

项目需求

• Python 3.10 或更高版本
• aiohttp >= 3.9.0，< 4.0.0
• aiohttp-sse >= 2.2.0，< 3.0.0
• anyio >= 4.9.0，< 5.0.0
• mcp >= 1.6.0，< 2.0.0

许可证

本项目采用 MIT 许可证 - 请查看 LICENSE 文件获取详细信息。

贡献

欢迎贡献！请随意提交 Pull Request。