STARWARCLOUD STARWAR.AI
返回市场
MCP数据库服务器

MCP数据库服务器

作者：executeautomation243 星标更新：2025-08-27
安装使用来源：spider==github.com

项目介绍

【技术文档摘要】： MseeP.ai 安全评估徽章

MCP 数据库服务器

此 MCP（模型上下文协议）服务器为 Claude 提供数据库访问能力，支持 SQLite、SQL Server、PostgreSQL 和 MySQL 数据库。

安装

  1. 克隆仓库：
git clone https://github.com/executeautomation/mcp-database-server.git
cd mcp-database-server
  1. 安装依赖：
npm install
  1. 构建项目：
npm run build

使用选项

有两种方式使用此 MCP 服务器与 Claude 集成：

  1. 直接使用：全局安装包并直接使用
  2. 本地开发：从本地开发环境运行

通过 NPM 包直接使用

最简单的方式是全局安装此 MCP 服务器：

npm install -g @executeautomation/database-server

这样就可以直接使用服务器，无需本地构建。

本地开发设置

如果你想要修改代码或从本地环境运行：

  1. 按照安装部分所示克隆并构建仓库
  2. 使用下面的使用部分中的命令运行服务器

使用

SQLite 数据库

要与 SQLite 数据库一起使用：

node dist/src/index.js /path/to/your/database.db

SQL Server 数据库

要与 SQL Server 数据库一起使用：

node dist/src/index.js --sqlserver --server <server-name> --database <database-name> [--user <username> --password <password>]

必需参数：

  • --server：SQL Server 主机名或 IP 地址
  • --database：数据库名称

可选参数：

  • --user：用于 SQL Server 身份验证的用户名（如果未提供，则使用 Windows 身份验证）
  • --password：用于 SQL Server 身份验证的密码
  • --port：端口号（默认：1433）

PostgreSQL 数据库

要与 PostgreSQL 数据库一起使用：

node dist/src/index.js --postgresql --host <host-name> --database <database-name> [--user <username> --password <password>]

必需参数：

  • --host：PostgreSQL 主机名或 IP 地址
  • --database：数据库名称

可选参数：

  • --user：用于 PostgreSQL 身份验证的用户名
  • --password：用于 PostgreSQL 身份验证的密码
  • --port：端口号（默认：5432）
  • --ssl：启用 SSL 连接（true/false）
  • --connection-timeout：连接超时时间（以毫秒为单位，默认：30000）

MySQL 数据库

标准认证

要与 MySQL 数据库一起使用：

node dist/src/index.js --mysql --host <host-name> --database <database-name> --port <port> [--user <username> --password <password>]

必需参数：

  • --host：MySQL 主机名或 IP 地址
  • --database：数据库名称
  • --port：端口号（默认：3306）

可选参数：

  • --user：用于 MySQL 身份验证的用户名
  • --password：用于 MySQL 身份验证的密码
  • --ssl：启用 SSL 连接（true/false 或对象）
  • --connection-timeout：连接超时时间（以毫秒为单位，默认：30000）

AWS IAM 认证

对于具有 IAM 数据库认证的 Amazon RDS MySQL 实例：

前提条件：

  • 必须配置 AWS 凭据（RDS 签名器使用默认凭证提供程序链）
  • 使用以下方法之一进行配置：
    • aws configure（使用默认配置文件）
    • AWS_PROFILE=myprofile 环境变量
    • AWS_ACCESS_KEY_ID 和 AWS_SECRET_ACCESS_KEY 环境变量
    • IAM 角色（如果在 EC2 上运行）
node dist/src/index.js --mysql --aws-iam-auth --host <rds-endpoint> --database <database-name> --user <aws-username> --aws-region <region>

必需参数：

  • --host：RDS 终端节点主机名
  • --database：数据库名称
  • --aws-iam-auth：启用 AWS IAM 认证
  • --user：AWS IAM 用户名（也是数据库用户）
  • --aws-region：RDS 实例所在的 AWS 区域

注意：对于 AWS IAM 认证，SSL 自动启用

配置 Claude Desktop

直接使用配置

如果你全局安装了包，请使用以下配置 Claude Desktop：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "mysql": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--mysql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--port", "3306",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "mysql-aws": {
      "command": "npx",
      "args": [
        "-y",
        "@executeautomation/database-server",
        "--mysql",
        "--aws-iam-auth",
        "--host", "your-rds-endpoint.region.rds.amazonaws.com",
        "--database", "your-database-name",
        "--user", "your-aws-username",
        "--aws-region", "us-east-1"
      ]
    }
  }
}

本地开发配置

对于本地开发，请配置 Claude Desktop 使用你本地构建的版本：

{
  "mcpServers": {
    "sqlite": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js", 
        "/path/to/your/database.db"
      ]
    },
    "sqlserver": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--sqlserver",
        "--server", "your-server-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "postgresql": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--postgresql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "mysql": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--mysql",
        "--host", "your-host-name",
        "--database", "your-database-name",
        "--port", "3306",
        "--user", "your-username",
        "--password", "your-password"
      ]
    },
    "mysql-aws": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-database-server/dist/src/index.js",
        "--mysql",
        "--aws-iam-auth",
        "--host", "your-rds-endpoint.region.rds.amazonaws.com",
        "--database", "your-database-name",
        "--user", "your-aws-username",
        "--aws-region", "us-east-1"
      ]
    }
  }
}

Claude Desktop 的配置文件通常位于：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json
  • Linux：~/.config/Claude/claude_desktop_config.json

可用的数据库工具

MCP 数据库服务器提供了以下工具，Claude 可以使用这些工具：

工具描述必需参数
read_query执行 SELECT 查询以读取数据query：SQL SELECT 语句
write_query执行 INSERT、UPDATE 或 DELETE 查询query：SQL 修改语句
create_table在数据库中创建新表query：CREATE TABLE 语句
alter_table修改现有表模式query：ALTER TABLE 语句
drop_table从数据库中删除表table_name：表名<br>confirm：安全标志（必须为 true）
list_tables获取所有表的列表无
describe_table查看表的架构信息table_name：表名
export_query将查询结果导出为 CSV/JSONquery：SQL SELECT 语句<br>format："csv" 或 "json"
append_insight向备忘录添加业务洞察insight：洞察文本
list_insights列出所有业务洞察无

有关如何使用这些工具与 Claude 的实际示例，请参阅 使用示例。

额外文档

开发

要在开发模式下运行服务器：

npm run dev

在开发过程中监视更改：

npm run watch

要求

  • Node.js 18+
  • 对于 SQL Server 连接性：SQL Server 2012 或更高版本
  • 对于 PostgreSQL 连接性：PostgreSQL 9.5 或更高版本

许可证

MIT