MCP 实战：查询数据库并保存结果为 JSON

场景概述

本场景演示如何组合使用 MCP PostgreSQL 工具和 Filesystem 工具，完成从数据库查询到结果保存的完整流程 [^1]。

前置条件

1. 已配置 mcp-server-postgres
2. 已配置 mcp-server-filesystem
3. 数据库可连接且有查询权限

完整流程

步骤 1：查询数据库

使用 postgres/query 工具执行 SQL 查询：

{
  "connection_string": "postgresql://user:pass@localhost:5432/mydb",
  "query": "SELECT * FROM users WHERE created_at > '2024-01-01'"
}

步骤 2：处理查询结果

查询结果以 JSON 格式返回：

{
  "rows": [
    {"id": 1, "name": "Alice", "email": "alice@example.com"},
    {"id": 2, "name": "Bob", "email": "bob@example.com"}
  ],
  "rowCount": 2
}

步骤 3：保存为 JSON 文件

使用 filesystem/write_file 工具保存结果：

{
  "path": "/Users/username/data/users_2024.json",
  "content": "{\"users\": [{\"id\": 1, ...}]}"
}

错误处理

数据库连接失败

• 检查连接字符串格式
• 确认数据库服务运行
• 验证网络连通性

文件写入失败

• 检查目录权限
• 确认路径在允许目录内
• 验证磁盘空间

最佳实践

1. 使用参数化查询防止 SQL 注入
2. 对大结果集分批处理
3. 添加时间戳到文件名避免覆盖
4. 验证 JSON 格式后再保存

参考来源

[^1]: MCP with Postgres - PostgreSQL MCP 工具使用指南
[^2]: PostgreSQL MCP Server Setup - PostgreSQL MCP 服务器配置教程