MCP Server Practice

🚀 🧠 MCP サーバー実践

FastAPI をベースとしたモジュール化されたサーバーで、FastMCP がサポートしています。AI ツール、数学演算、ウェブ検索、音声応答生成、外部 API 統合の実際のアプリケーションを示しています。

🚀 クイックスタート

このサーバーは FastAPI をベースに構築されており、FastMCP がサポートしています。以下のコマンドでサーバーを起動できます。

mcp.run(transport="stdio")

✨ 主な機能

🔧 数学ツール

• add(a, b): 2 つの整数の和を返します。
• multiply(a, b): 2 つの整数の積を返します。

🌤️ 天気 API 統合

• get_weather(city): 天気 API を使用して、指定した都市のリアルタイムの天気データを取得します。

🌐 ウェブ検索（OpenAI ツール経由）

• web_search(query): OpenAI のウェブ検索ツールを使用してリアルタイム検索を実行し、簡潔な結果を返します。

🔊 音声応答生成

• audio_query(text): OpenAI の gpt-4o 音声機能を使用して、テキストクエリを音声応答（WAV 形式）に変換します。音声ファイルは自動的に /audio フォルダに保存されます。

🙋♂️ カスタムリソースの例

• greeting://{name}: リソースベースのルーティングを使用して、個別の挨拶文字列を返します。

🔧 技術詳細

🛠️ 使用されている技術

• FastMCP: ツールベースのワークフローのサーバーインターフェース。
• FastAPI: 高性能 API の Web フレームワーク。
• OpenAI: AI ベースの検索、チャット、音声生成機能を提供します。
• 天気 API: リアルタイムの天気更新用の外部 API。
• Python + dotenv: スクリプトの作成と安全な環境変数の処理に使用されます。

💻 動作原理

各ツールは @mcp.tool() デコレータを使用して定義されており、AI エージェントまたは CLI ツールから呼び出し可能なインターフェースとして利用できます。サーバーを起動するには、次のコマンドを実行します。

mcp.run(transport="stdio")