Awesome MCP Fastapi

🚀 MCP FastAPI 優れたプロジェクト

このプロジェクトは、FastAPI をベースにした強力な Model Context Protocol (MCP) の実装で、拡張されたツールレジストリ機能を備え、成熟した FastAPI エコシステムを最大限に活用しています。

🚀 クイックスタート

前提条件

• Python 3.10+

インストール

# リポジトリをクローンする
git clone https://github.com/yourusername/awesome-mcp-fastapi.git
cd awesome-mcp-fastapi

# 仮想環境を作成する
python -m venv .venv
source .venv/bin/activate  # Windowsの場合は：.venv\Scripts\activate

# 依存関係をインストールする
pip install -e .

サーバーを起動する

uvicorn src.main:app --reload

http://localhost:8000/docs にアクセスして、OpenAPI ドキュメントを確認します。

✨ 主な機能

概要

MCP 優れた FastAPI は、本番環境で使用可能な MCP の実装で、FastAPI の成熟したエコシステムを統合することで、標準の MCP 機能を強化しています。このプロジェクトは、改良されたツールレジストリシステムを提供し、大規模言語モデル (LLMs) のツールの作成、管理、およびドキュメント化をより簡単にします。

標準 MCP より優れている理由

Model Context Protocol は、AI モデルをツールやデータソースに接続するための良好な基盤を提供しますが、当社の実装はいくつかの顕著な利点を提供します。

FastAPI の成熟したエコシステム

• 本番環境に対応した Web フレームワーク：高性能で現代的な Web フレームワークである FastAPI をベースにしており、自動的に OpenAPI ドキュメントを生成します。
• 依存性注入のサポート：FastAPI の強力な依存性注入システムを利用して、より保守しやすくテストしやすいコードを実現します。
• ミドルウェアのサポート：認証、監視、その他のミドルウェアコンポーネントを簡単に統合できます。
• 組み込みの検証：Pydantic を通じて強力なリクエスト/レスポンス検証とデータモデリングを実現します。
• 非同期サポート：async/await パターンをサポートしており、高い並行性を持つアプリケーションに適しています。

拡張されたツールレジストリ

当社の実装は、以下の方法で標準の MCP ツールレジストリを改良しています。

• 自動ドキュメント生成：ツールは自動的に MCP 形式と OpenAPI 仕様のドキュメントを生成します。
• 改良された型ヒント：拡張された型情報の抽出により、ツールのサポートと IDE の体験が向上します。
• より豊富なスキーマ定義：より表現力のある JSON Schema でツールの入力と出力を定義します。
• より良いエラー処理：詳細な情報を含む構造化されたエラーレスポンスを提供します。
• 拡張されたドキュメント文字列のサポート：Python のドキュメント文字列から情報をより適切に抽出します。

追加機能

• CORS サポート：クロスオリジンリクエストをサポートしており、Web アプリケーションとの統合が容易です。
• ライフサイクル管理：FastAPI のライフサイクル API を通じて、リソースの初期化とクリーンアップを実現します。

💻 使用例

基本的な使用法

ツールの作成

from fastapi import FastAPI
from src.utils.tools import create_tool

app = FastAPI()
my_tool = create_tool(...)
app.include_router(my_tool.router)

リクエスト形式

/tools/your-tool-id に POST リクエストを送信し、リクエストボディは以下のようにします。

{
  "inputs": {
    "param1": "value1",
    "param2": "value2"
  },
  "options": {
    "timeout": 3000,
    "some_option": true
  }
}

📚 ドキュメント

アーキテクチャ

このプロジェクトはモジュール化されたアーキテクチャを使用しています。

• app：メインアプリケーションのエントリポイント。
• tools：ツールの定義と登録。
• routers：ルーティングの設定。
• models：データモデルと検証。

awesome-mcp-fastapi/
├── app.py
├── models/
│   └── __init__.py
├── routers/
│   └── __init__.py
└── tools/
    └── __init__.py

Docker サポート

ビルドと実行：

docker build -t awesome-mcp-fastapi .
docker run -p 8000:8000 --env-file .env awesome-mcp-fastapi

貢献

貢献を歓迎します！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。