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。