A Model Context Protocol (MCP) server built with FastMCP that exposes a tool for querying customer orders from a PostgreSQL database.
├── mcp_server.py # FastMCP server — stdio transport (default), HTTP optional
├── mcp_client.py # Demo client — connects via stdio, calls the tool
├── .env.example # Template for DB credentials
├── requirements.txt # Python dependencies
├── schema.sql # DDL to create customers + orders tables
├── seed.sql # Sample data for local testing
└── README.md # This fileRelated MCP server: Mock Store MCP Server
Python ≥ 3.10
PostgreSQL instance with a database containing the schema described below
サーバーは2つのテーブルを想定しています：
テーブル | カラム |
|
|
|
|
提供されたSQLファイルを実行して作成します：
psql -d orders_db -f schema.sql
psql -d orders_db -f seed.sqlpip install -r requirements.txtenvテンプレートをコピーし、接続詳細を記入してください：
cp .env.example .env
nano .env # edit values to match your PostgreSQL instancepython mcp_server.pyこれはローカルMCPサーバーの標準モードで、Claude Desktop、MCP Inspector、およびstdio互換のクライアントで動作します。
python mcp_server.py --transport http --port 9000クライアントがローカルプロセスではなくリモートHTTPエンドポイントを必要とする場合に便利です。
バンドルされたクライアントはstdio経由でサーバーに接続し、3つのテストシナリオを実行します：
python mcp_client.py期待される出力（シードデータがロードされた状態）：
[TEST 1] Orders for customer_id=1 with min_amount=100.0
Order ID Date Amount (€) Status
--------------------------------------------------------
5 2025-06-15 180.75 € completed
3 2025-03-01 520.00 € shipped
1 2025-01-10 250.00 € completed
→ 3 order(s) found
[TEST 2] Orders for 'carlos@example.com' with min_amount=300.0
Order ID Date Amount (€) Status
--------------------------------------------------------
8 2025-05-10 890.00 € shipped
6 2025-02-01 340.00 € completed
→ 2 order(s) found
[TEST 3] Lookup nonexistent email (expecting error)
⚠ Customer not found (nobody@nowhere.com)MCP InspectorはMCPサーバーを探索するためのインタラクティブなツールです。
npx @modelcontextprotocol/inspector node mcp_server.jsPythonサーバーの場合：
npx @modelcontextprotocol/inspector python mcp_server.pyインスペクタはhttp://localhost:6287でブラウザウィンドウを開きます。
UIで、ツールの下にあるget_customer_orders_above_amountを見つけます。
パラメータを入力し（例：{"customer_id": 1, "min_amount": 100}）、Callをクリックします。
構造化されたJSONレスポンスを確認します。
get_customer_orders_above_amount合計がユーロで最低金額を超える顧客の注文を取得します。
パラメータ | 型 | 必須 | 説明 |
|
| いいえ | 顧客の主キー（両方指定された場合は優先） |
|
| いいえ | 代替検索用のメールアドレス |
|
| いいえ | ユーロでの最低注文金額（含む、デフォルト0.0） |
customer_idまたはcustomer_emailの少なくとも一方を指定する必要があります。
戻り値: list[dict] — 各dictはキーorder_id、order_date、total_amount、statusを持ちます。結果はorder_dateの降順で並べられます。
エラーレスポンスは、"error"キーを持つ単一のdictを含むリストとして返されます（生のスタックトレースはクライアントに漏れません）。
ハードコードされた認証情報はありません — すべてのDBパラメータはpython-dotenvを介して読み込まれた環境変数から取得されます。
パラメータ化されたクエリのみ — SQLインジェクションは、$1、$2プレースホルダーを全体で使用することで防止されます。
コネクションプーリング — asyncpgプール（2～10接続）がサーバー起動時に一度作成され、シャットダウン時に閉じられます。
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Query PostgreSQL databases in plain English — LLM-generated, safety-validated SQL.
Comprehensive PostgreSQL documentation and best practices, including ecosystem tools
Manage Supabase projects end to end across database, auth, storage, realtime, and migrations. Moni…
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/masalinas/poc-ai-mcp-claude-code'
If you have feedback or need assistance with the MCP directory API, please join our Discord server