Aiohttp MCP

🚀 aiohttp-mcp

このツールは、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)

サブアプリの設定

既存の aiohttp アプリに MCP を統合する例：

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 でフォーマット：

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 を送信してください。