Python MCP Cat の豆知識

Server-Sent Events (SSE) トランスポートを使用してモデル コンテキスト プロトコル (MCP) を実装し、cat ファクトを提供する FastAPI サーバー。

特徴

• ランダムに猫の豆知識を1つ入手

• 10秒ごとに配信される猫の豆知識のストリームを購読してください

• リアルタイム通信のためのSSE（サーバー送信イベント）

• 自動 OpenAPI ドキュメントを備えた FastAPI フレームワーク

Related MCP server: FastAPI MCP SSE

要件

• Python 3.12以上

• 依存関係:

  • ファスタピ

  • mcp[cli]

  • ウビコーン

  • cmake

インストール

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

git clone <repository-url>
cd python-mcp

仮想環境を作成する

python -m venv venv
source venv/bin/activate  # On Windows, use: venv\Scripts\activate

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

pip install -e .

SSEモードでサーバーを起動する

uv run コマンドを使用してサーバーを起動します。

uv run start

サーバーが稼働すると、次の場所で利用できるようになります:

• API: http://localhost:8000

• APIドキュメント: http://localhost:8000/docs

VSコード統合

この MCP サーバーを VS Code で使用するには、 mcp.jsonファイルに次の構成を追加する必要があります。

{
    "servers": {
        "mcp-sse": {
            "type": "sse",
            "url": "http://0.0.0.0:8000/sse"
        }
    }
}

この構成は、SSE トランスポートを使用して MCP サーバーに接続する方法を VS Code に指示します。

Cat Facts APIの使用

猫に関する事実:

SSEエンドポイントに接続し、猫に関する情報を1つリクエストします。レスポンスは常に「Hi!」で始まります。

APIエンドポイント

• GET / : ホームページ

• GET /about : アプリケーションに関する情報

• GET /status : 現在のサーバーステータス

• GET /sse : MCP通信用のSSEエンドポイント

• GET /docs : API ドキュメント (Swagger UI)

• GET /redoc : 代替 API ドキュメント (ReDoc)

ライセンス

マサチューセッツ工科大学