MCP PostgreSQL 查询服务器

一个模型上下文协议（MCP）服务器的实现，用于以只读模式查询 PostgreSQL 数据库，设计与 Claude Desktop 和其他 MCP 客户端配合使用。

概述

该项目实现了以下功能的模型上下文协议（MCP）服务器：

1. 提供安全的只读接口访问 PostgreSQL 数据库
2. 与 Claude Desktop 集成通过 MCP 协议
3. SQL 查询验证，确保仅执行 SELECT 查询
4. 查询超时保护（10 秒）

先决条件

• Node.js (v14 或更高版本)
• npm（随 Node.js 提供）
• PostgreSQL 数据库（通过命令行提供的连接详细信息）

安装

# 克隆仓库
git clone https://github.com/RathodDarshil/mcp-postgres-query-server.git
cd mcp-postgres-query-server

# 安装依赖项
npm install

# 构建项目
npm run build

连接到 Claude Desktop

您可以配置 Claude Desktop 自动启动并连接到 MCP 服务器：

1. 访问 Claude Desktop 配置文件：

   • 打开 Claude Desktop
   • 转到 设置 > 开发者 > 编辑配置
   • 这将在默认文本编辑器中打开配置文件

2. 在 claude_desktop_config.json 的 mcpServers 部分添加 postgres-query 服务器：

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/path/to/your/mcp-postgres-query-server/dist/index.js",
                "postgresql://username:password@hostname:port/database"
            ]
        }
    }
}

3. 将 /path/to/your/ 替换为您实际项目的路径。
4. 将 PostgreSQL 连接字符串替换为您的实际数据库凭据。
5. 保存文件并重新启动 Claude Desktop。MCP 服务器现在应该出现在 设置 中的 MCP 服务器选择下拉菜单中。

示例配置

以下是带有 postgres-query 的完整配置文件示例：

{
    "mcpServers": {
        "postgres-query": {
            "command": "node",
            "args": [
                "/Users/darshilrathod/mcp-servers/mcp-postgres-query-server/dist/index.js",
                "postgresql://user:password@localhost:5432/mydatabase"
            ]
        }
    }
}

更新配置

要更新您的 Claude Desktop 配置：

1. 打开 Claude Desktop
2. 转到 设置 > 开发者 > 编辑配置
3. 对配置文件进行修改
4. 保存文件
5. 重新启动 Claude Desktop 以使更改生效
6. 如果您已更新 MCP 服务器代码，请确保在重新启动之前使用 npm run build 重建

功能

• 只读数据库访问：仅允许 SELECT 查询，以保证安全
• 查询验证：阻止潜在的有害 SQL 操作
• 超时保护：运行时间超过 10 秒的查询将被自动终止
• MCP 协议支持：完整的模型上下文协议实现
• JSON 响应格式化：查询结果以结构化的 JSON 格式返回

API

工具

query-postgres

对配置的 PostgreSQL 数据库执行只读 SQL 查询。

参数：

• query (string)：要执行的 SELECT SQL 查询

响应：

• 包含以下内容的 JSON 对象：
  • rows：结果集行
  • rowCount：返回的行数
  • columns：查询的结果列

示例

{
  "query": "SELECT * FROM users LIMIT 5",
  "result": {
    "rows": [
      { "id": 1, "name": "Alice" },
      { "id": 2, "name": "Bob" }
    ],
    "rowCount": 2,
    "columns": ["id", "name"]
  }
}

开发

• 项目结构：

  • src/：包含核心的服务器实现
  • dist/：构建输出目录
  • package.json：项目依赖和脚本
  • README.md：项目文档

• 贡献指南：

  • 提交代码前，请确保通过 npm 脚本运行测试。
  • 遵循项目的代码规范。

安全考虑

• 确保数据库凭据的安全性，避免在代码中明文存储。
• 使用环境变量或配置管理工具来管理敏感信息。
• 定期审计和更新服务器安全策略。