MCP Fastapi Learning

🚀 FastAPI こんにちは、世界！アプリケーション

FastAPI と MCP SSE サポートを使用して構築された、シンプルな Hello World API です。

✨ 主な機能

• ルートルート：Hello World メッセージを返します。
• 名前パラメータ付きの動的な挨拶インターフェース。
• OpenAI の GPT - 4o モデルを統合し、高度な AI チャット機能を実現します。
• API ドキュメントを自動生成し、Swagger UI を提供します。

📦 インストール

このアプリケーションは、ローカルまたは Docker を使用して実行できます。

ローカルインストール

1. リポジトリをクローンする

git clone https://github.com/xxradar/mcp-test-repo.git
cd mcp-test-repo

2. 仮想環境を作成する（オプションですが推奨）

# macOS/Linux システムで
python -m venv venv
source venv/bin/activate

# Windows システムで
python -m venv venv
venv\Scripts\activate

3. 依存関係をインストールする

pip install -r requirements.txt

4. アプリケーションを実行する

uvicorn main:app --reload

アプリケーションが起動すると、http://127.0.0.1:8000 で利用できます。 または、Python を直接使用して実行することもできます。

python main.py

Docker インストール

1. リポジトリをクローンする

git clone https://github.com/xxradar/mcp-test-repo.git
cd mcp-test-repo

2. Docker イメージをビルドする

docker build -t fastapi-hello-world .

3. Docker コンテナを実行する

docker run -p 8000:8000 fastapi-hello-world

アプリケーションは http://localhost:8000 で利用できます。

📚 ドキュメント

API インターフェース

• GET /：シンプルな Hello World メッセージを返します。
• GET /hello/{name}：指定された名前に基づいて、個別の挨拶メッセージを返します。
• GET /openai：OpenAI の GPT - 4o モデルを使用して応答します（オプションの prompt クエリパラメータを受け付けます）。
• GET /docs：Swagger UI ドキュメント画面。
• GET /redoc：ReDoc ドキュメント画面。

OpenAI 統合

/openai インターフェースは OpenAI の GPT - 4o モデルを使用し、環境に OpenAI API キーを設定する必要があります。

ローカルインストール

# OpenAI API キーを環境変数に設定する
export OPENAI_API_KEY=your_api_key_here

# アプリケーションを実行する
uvicorn main:app --reload

Docker インストール

# OpenAI API キーを使用して Docker コンテナを実行する
docker run -p 8000:8000 -e OPENAI_API_KEY=your_api_key_here fastapi-hello-world

💻 使用例

curl を使用する

# Hello World メッセージを取得する
curl http://127.0.0.1:8000/

# 個別の挨拶メッセージを取得する
curl http://127.0.0.1:8000/hello/World

# Swagger UI ドキュメント画面にアクセスする
curl http://127.0.0.1:8000/docs

# OpenAI インターフェースを使用してサンプルリクエストを行う
curl -X POST "http://127.0.0.1:8000/openai/?prompt=こんにちは%2C+私は初心者です。何か教えてくれますか？"

Swagger UI を使用する

1. ブラウザを開き、http://127.0.0.1:8000/docs にアクセスします。
2. ドキュメント画面で、/openai インターフェースを見つけます。
3. このインターフェースの「Try It Out」ボタンをクリックします。
4. prompt パラメータに質問やプロンプトを入力します。例：「こんにちは、私は初心者です。何か教えてくれますか？」
5. 「Execute」ボタンをクリックして、OpenAI の応答を確認します。

⚠️ 重要提示

• インストール時には、Python バージョンが 3.7 以上であることを確認してください。
• Docker を使用する場合は、必要に応じてポートマッピングやその他の設定を調整してください。
• 本番環境で使用する前に、OpenAI API キーが正しく設定されていることを確認し、費用と使用制限を理解してください。