Aiohttp MCP

🚀 aiohttp-mcp

这是一个基于 aiohttp 的工具，用于构建 Model Context Protocol (MCP) 服务器，能与 aiohttp 轻松集成，具备异步优先设计等特性。

✨ 主要特性

• 与 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 .

项目需求

📄 许可证

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

💡 贡献

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