MCP Testing Server

🚀 FastAPI テストサーバー

このリポジトリには、API 開発とテストに使用する FastAPI ベースのテストサーバーが含まれています。

🚀 クイックスタート

FastAPI は、Python 3.7 以上で動作する、現代的で高性能な Web フレームワークで、標準の Python 型ヒントを使用して API を構築することができます。使いやすく学びやすい設計で、本番環境でも十分な機能を備えています。

✨ 主な機能

• 高速：性能が非常に高く、NodeJS や Go に匹敵します。
• 直感的：優れたエディターサポート（自動補完）があります。
• シンプル：使いやすく学びやすいように設計されています。
• 簡潔：コードの重複を最小限に抑えます。
• 堅牢：本番環境で使用できるコードを生成し、インタラクティブなドキュメントも提供します。
• 標準準拠：OpenAPI や JSON Schema などのオープン標準 API と完全に互換性があります。

📦 インストール

前提条件

• Python 3.7 以上
• pip（Python パッケージインストーラー）

インストール手順

# 仮想環境の作成
python -m venv venv
source venv/bin/activate  # Windowsの場合: venv\Scripts\activate

# FastAPI と Uvicorn（ASGI サーバー）のインストール
pip install fastapi uvicorn

# オプションの依存関係
pip install python-multipart  # フォームデータ用
pip install pydantic[email]   # メールアドレスの検証用

💻 使用例

基本的な使用法

from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"Hello": "World"}

@app.get("/items/{item_id}")
def read_item(item_id: int, q: str = None):
    return {"item_id": item_id, "q": q}

サーバーの起動

uvicorn main:app --reload

サーバーは http://127.0.0.1:8000 で起動します。

📚 ドキュメント

FastAPI は自動的にインタラクティブな API ドキュメントを生成します。

• Swagger UI：http://127.0.0.1:8000/docs
• ReDoc：http://127.0.0.1:8000/redoc

🔧 技術詳細

プロジェクト構成

.
├── app/
│   ├── __init__.py
│   ├── main.py          # FastAPI アプリケーション
│   ├── dependencies.py  # 依存関係、ミドルウェアなど
│   ├── routers/         # API ルートモジュール
│   ├── models/          # Pydantic モデル
│   ├── schemas/         # リクエスト/レスポンススキーマ
│   ├── crud/            # データベース CRUD 操作
│   ├── db/              # データベースモデルと設定
│   └── core/            # コア機能
├── tests/               # テストモジュール
├── .env                 # 環境変数
├── .gitignore
├── requirements.txt
└── README.md

デプロイ

FastAPI アプリケーションは、以下の複数のプラットフォームにデプロイできます。

• Docker
• Heroku
• AWS Lambda
• Google Cloud Run
• Azure Functions
• 従来のサーバー（Gunicorn/Uvicorn 使用）

🤝 貢献

貢献いただける場合は大歓迎です！自由に Pull Request を送信してください。

📄 ライセンス

このプロジェクトは MIT License に基づいて配布されています。詳細は LICENSE ファイルを参照してください。