既存の Business-as-Usual (BAU) REST マイクロサービスと、Model Context Protocol (MCP) を通じて AI エージェントが連携する方法を示す、実行可能な概念実証です。
このデモンストレーションでは、Google Gemini を使用して MCP ツールを発見し、顧客情報と注文情報を取得し、制御された注文キャンセル操作を実行します。BAU サービスは独立した REST API のままであり、MCP がそれらの API とエージェントの間の統合境界を提供します。
含まれるシナリオでは、エージェントに次のことを要求します。
CUST-1001 のプロファイルを取得する。
顧客の注文を一覧表示する。
Processing ステータスの注文を特定する。
指定された理由で ORD-9002 をキャンセルする。
完了した作業を要約する。
期待されるツールシーケンスは次のとおりです。
Gemini agent
-> MCP tool discovery over stdio
-> MCP server
-> Customer and Order REST APIs
-> Tool results returned to Gemini
-> Final user-facing summaryRelated MCP server: MCP API Tool Demo
+------------------+ stdio +------------------+ HTTP +----------------------+
| Gemini agent | <----------------> | MCP server | <--------------> | Customer service |
| agent_runner.py | | server.py | | localhost:8001 |
+------------------+ +--------+---------+ +----------------------+
|
| HTTP
v
+----------------------+
| Order service |
| localhost:8002 |
+----------------------+Tool | 目的 |
| 顧客プロファイル、ティア、ステータス、与信限度額を取得します。 |
| 顧客に関連付けられた注文を一覧表示します。 |
| ステータスがキャンセルを許可している場合に注文をキャンセルします。 |
.
├── agent/
│ └── agent_runner.py # Gemini agent and MCP client
├── mcp_server/
│ └── server.py # MCP tools and REST integration
├── services/
│ ├── customer_service.py # Mock customer REST API
│ └── order_service.py # Mock order REST API
├── tests/
│ └── test_services.py # Service behavior tests
├── .env.example # Environment variable template
├── requirements.txt # Python dependencies
└── mcp_microservices_poc_blueprint.md
# Detailed design and implementation referencePython 3.11 以降
Google AI Studio の Gemini API キー
Windows PowerShell、macOS/Linux シェル、または同等のターミナル
エージェント実行時に Gemini API へのネットワークアクセス
このプロジェクトには Anthropic または OpenAI の API キーは必要ありません。
プロジェクトディレクトリで PowerShell を開きます。
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -r requirements.txt
Copy-Item .env.example .env.env を開き、your_gemini_api_key_here を自分のキーに置き換えます。
GOOGLE_API_KEY=your_gemini_api_key_here
GEMINI_MODEL=gemini-3.6-flash.env をコミットしたり、API キーをソースコードに配置したりしないでください。選択したモデルがお使いの Gemini アカウントで利用可能である必要があります。
3 つのターミナルを使用します。各ターミナルで .venv をアクティベートします。
python services/customer_service.pyhttp://localhost:8001 で実行されます。
python services/order_service.pyhttp://localhost:8002 で実行されます。
python agent/agent_runner.pyエージェントは MCP サーバーを子プロセスとして起動し、そのツールを発見して、サンプルワークフローを実行します。
2 つのサービスがアクティブな状態で、次のコマンドを実行します。
Invoke-RestMethod http://localhost:8001/health
Invoke-RestMethod http://localhost:8002/health
Invoke-RestMethod http://localhost:8001/api/v1/customers/CUST-1001
Invoke-RestMethod http://localhost:8002/api/v1/orders/customer/CUST-1001仮想環境をアクティブにした状態で：
python -m pytest -qテストでは、大文字と小文字を区別しない顧客検索、存在しない顧客、処理中の注文のキャンセル、および出荷済みの注文のキャンセル防止をカバーしています。
Variable | 説明 | デフォルト |
| Gemini 認証キー。 | 必須 |
| エージェントが使用する Gemini モデル。 |
|
| 顧客サービスのベース URL。 |
|
| 注文サービスのベース URL。 |
|
これはローカル向けの、意図的に小規模な POC であり、統合パターンを簡単に確認して実行できるようにすることを目的としています。
顧客および注文レコードはメモリ内に保存され、サービスが再起動するとリセットされます。
サービスは認証または認可を実装していません。
キャンセル操作は、実際のシステムでは承認およびビジネスポリシー制御によって保護されるべきです。
MCP はローカルプロセス統合に stdio を使用します。デプロイされたアーキテクチャでは、認証されたネットワークトランスポートを使用する必要があります。
下流のエラーは可視化のためにツールテキストとして返されます。本番システムでは、構造化エラー、リトライ、トレーシング、およびメトリクスを使用する必要があります。
サンプルエージェントは実際の Gemini API リクエストを行うため、有効なキーが必要です。
GOOGLE_API_KEY is not set.env がプロジェクトディレクトリに存在し、有効なキーが含まれていることを確認してください。プロジェクトディレクトリからエージェントを実行してください。
404 NOT_FOUND.env の GEMINI_MODEL を、アカウントで有効なモデルに設定してください。この POC のデフォルトは gemini-3.6-flash です。
依存関係がアクティブな仮想環境にインストールされていることを確認してください。
python -m pip install -r requirements.txtこのプロジェクトは、サーバー実装が FastMCP を使用しているため、MCP を 1.x API 範囲に固定しています。
両方の REST サービスがポート 8001 と 8002 で実行されていることを確認してください。ポートがすでに使用されている場合は、サービスポートと .env 内の対応する URL を更新してください。
This server cannot be deployed
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Unified MCP Server is a remote MCP connector for AI agents and vertical AI products that provides access to 22,000+ authorized SaaS tools across 400+ integrations and 24 categories directly inside LLMs (Claude, GPT, Gemini, Cohere). Tools operate only on explicitly authorized customer connections, enabling agents to safely read and write against live third-party systems.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
