# @executeautomation/database-server 中文文档

规范地址：https://npmcn.com/package/%40executeautomation/database-server/

版本：1\.1\.0
npm 元数据更新时间：2025-05-30T20:38:56.593Z
中文译文更新时间：2026-11-14T03:24:18.110Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40executeautomation/database-server
原文对照：https://npmcn.com/package/%40executeautomation/database-server/?lang=original
项目主页：https://github.com/executeautomation/mcp-database-server

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：60.9 kB，16 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：5 个
- 首次发布：2025-04-14T03:54:02.180Z
- 最新版本发布：2025-05-30T20:38:56.403Z
- 近 30 天下载量：3331（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：4（近 12 个月 0 个）

## 中文简介

通过ExecuteAutomation与 SQLite 和 SQL 服务器数据库交互的 MCP 服务器

## 安装

```sh
npm install @executeautomation/database-server
```

也可以使用：`pnpm add @executeautomation/database-server`、`yarn add @executeautomation/database-server`、`bun add @executeautomation/database-server`

## README

[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/executeautomation-mcp-database-server-badge.png)](https://mseep.ai/app/executeautomation-mcp-database-server)

# MCP 数据库服务器

这个MCP(模式上下文协议)服务器为克洛德提供数据库访问能力,支持SQLite,SQL服务器,PostgreSQL,和MySQL数据库.

## 安装

1.  清除仓库 :

```
git clone https://github.com/executeautomation/database-server.git
cd database-server
```

2.  安装依赖性 :

```
npm install
```

3.  构建工程 :

```
npm run build
```

## 用法选项

与克洛德使用这个MCP服务器有两种方法:

1.  **直接使用**: 在全球安装软件包并直接使用
2.  **地方发展**: 从您的本地发展环境运行

### 直接使用国家防范机制一揽子计划

使用此 MCP 服务器的最简单方法是在全球安装:

```bash
npm install -g @executeautomation/database-server
```

这使得您可以直接使用服务器而无需在本地建立它.

### 本地开发设置

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

1.  如安装部分所示, 克隆并构建寄存器
2.  使用下面使用区的命令运行服务器

## 使用量

### SQLite 数据库

要使用 SQLite 数据库 :

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

### SQL 服务器数据库

要使用 SQL 服务器数据库 :

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

所需参数 :

-   `--server`编号: SQL 服务器主机名称或IP地址
-   `--database`: 数据库名称

可选参数 :

-   `--user`: SQL 服务器认证的用户名( 如果没有提供, 将使用 Windows 认证)
-   `--password`: SQL 服务器认证的密码
-   `--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 连接( 真/假)
-   `--connection-timeout`: 以毫秒计的连接超时( 默认: 3000)

### 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 连接( 真/ 假或对象)
-   `--connection-timeout`: 以毫秒计的连接超时( 默认: 3000)

## 配置 Claude 桌面

### 直接使用配置

如果您在全球安装了软件包, 请配置 Claude 桌面 :

```json
{
  "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"
      ]
    }
  }
}
```

### 地方发展配置

对于本地开发, 请配置 Claude 桌面以使用本地构建的版本 :

```json
{
  "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"
      ]
    }
  }
}
```

Claude 桌面配置文件一般位于:

-   马可斯: `~/Library/Application Support/Claude/claude_desktop_config.json`
-   窗口 : `%APPDATA%\Claude\claude_desktop_config.json`
-   林纳: `~/.config/Claude/claude_desktop_config.json`

## 可用的数据库工具

MCP数据库服务器提供了克洛德可以使用的以下工具:

| 工具 | 说明 | 所需参数 |
| --- | --- | --- |
| `read_query` | 执行 SELECT 查询以读取数据 | `query`: SQL SELECT 语句 |
| `write_query` | 执行InSert、更新或DEELET查询 | `query`: SQL 修改语句 |
| `create_table` | 在数据库中创建新表格 | `query`报表 |
| `alter_table` | 修改现有的表格方案 | `query`: 其他报表 |
| `drop_table` | 从数据库中删除表格 | `table_name`表格名称  
`confirm`: 安全旗 (必须是真实的) |
| `list_tables` | 获取所有表格列表 | 无 |
| `describe_table` | 查看表格的计划信息 | `table_name`表格名称 |
| `export_query` | 导出查询结果为 CSV/ JSON | `query`: SQL SELECT 语句  
`format`:"csv"或"json" (中文(简体) ) |
| `append_insight` | 在备忘录中添加商业洞察力 | `insight`: 见解文本 |
| `list_insights` | 列出所有商业见解 | 无 |

关于如何与克洛德一起使用这些工具的实际例子,请参见: [用法实例](https://npmcn.com/package/%40executeautomation/database-server/docs/usage-examples.md)。 。 。 .

## 其他文档

-   [SQL 服务器设置指南](https://npmcn.com/package/%40executeautomation/database-server/docs/sql-server-setup.md): 连接到 SQL 服务器数据库的细节
-   [PostgreSQL 设置指南](https://npmcn.com/package/%40executeautomation/database-server/docs/postgresql-setup.md): 连接到 PostgreSQL 数据库的细节
-   [用法实例](https://npmcn.com/package/%40executeautomation/database-server/docs/usage-examples.md): 与 Claude 一起使用的示例查询和命令

## 发展

要以开发模式运行服务器 :

```
npm run dev
```

注意开发过程中的变化:

```
npm run watch
```

## 所需资源

-   节点.js 18+
-   用于 SQL 服务器连接: SQL 服务器 2012年或以后
-   用于 PostgreSQL 连接: PostgreSQL 9.5 或以后

## 许可证

麻省理工学院

## 常见问题

### @executeautomation/database-server 是什么？

通过ExecuteAutomation与 SQLite 和 SQL 服务器数据库交互的 MCP 服务器

### 如何安装 @executeautomation/database-server？

在项目目录运行 npm install @executeautomation/database-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ea-database-server，可以用 npx ea-database-server 直接运行。

### @executeautomation/database-server 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/executeautomation\_\_database-server 是否存在。

### @executeautomation/database-server 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @executeautomation/database-server 可以商用吗？

@executeautomation/database-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @executeautomation/database-server 的下载量有多少？

根据 npm 官方下载统计，@executeautomation/database-server 在 2026/10/14 – 2026/11/12 这 30 天内被下载 3,331 次，日均约 111 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @executeautomation/database-server 还在维护吗？

最新版本 1\.1\.0 发布于 2025/05/31（1\.5 年前）；至今共发布 4 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/04/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。