一个基于 FastMCP 构建的模型上下文协议 (MCP) 服务器，提供了一个用于从 PostgreSQL 数据库查询客户订单的工具。
├── 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 实例，包含一个具有以下描述的数据库
服务器期望两张表：
表 | 列 |
|
|
|
|
运行提供的 SQL 文件来创建它们：
psql -d orders_db -f schema.sql
psql -d orders_db -f seed.sqlpip install -r requirements.txt复制环境变量模板并填写你的连接信息：
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 连接到服务器，并运行三个测试场景：
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.js对于 Python 服务器：
npx @modelcontextprotocol/inspector python mcp_server.pyInspector 会在浏览器中打开一个窗口，地址为 http://localhost:6287。
在 UI 中，找到 get_customer_orders_above_amount 位于 Tools 下。
填写参数（例如 {"customer_id": 1, "min_amount": 100}）并点击 Call。
检查结构化的 JSON 响应。
get_customer_orders_above_amount检索总金额超过指定欧元最小值的客户订单。
参数 | 类型 | 必需 | 描述 |
|
| 否 | 客户的主键（如果同时提供，则优先使用） |
|
| 否 | 用于替代查找的电子邮件地址 |
|
| 否 | 最小订单金额（欧元，包含，默认 0.0） |
必须至少提供 customer_id 或 customer_email 中的一个。
返回： list[dict]——每个字典包含键 order_id、order_date、total_amount、status。结果按 order_date 降序排列。
错误响应 返回为一个包含单个字典的列表，字典中有一个 "error" 键（原始的堆栈跟踪不会泄露给客户端）。
没有硬编码的凭据——所有数据库参数都来自通过 python-dotenv 加载的环境变量。
仅使用参数化查询——通过在所有地方使用 $1、$2 占位符来防止 SQL 注入。
连接池——在服务器启动时创建一个 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