MCP 数据库服务器
这个MCP(模式上下文协议)服务器为克洛德提供数据库访问能力,支持SQLite,SQL服务器,PostgreSQL,和MySQL数据库.
安装
- 清除仓库 :
git clone https://github.com/executeautomation/database-server.git
cd database-server
- 安装依赖性 :
npm install
- 构建工程 :
npm run build
用法选项
与克洛德使用这个MCP服务器有两种方法:
- 直接使用: 在全球安装软件包并直接使用
- 地方发展: 从您的本地发展环境运行
直接使用国家防范机制一揽子计划
使用此 MCP 服务器的最简单方法是在全球安装:
npm install -g @executeautomation/database-server
这使得您可以直接使用服务器而无需在本地建立它.
本地开发设置
如果您想要修改代码或从本地环境运行 :
- 如安装部分所示, 克隆并构建寄存器
- 使用下面使用区的命令运行服务器
使用量
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 桌面 :
{
"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 桌面以使用本地构建的版本 :
{
"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 | 列出所有商业见解 | 无 |
关于如何与克洛德一起使用这些工具的实际例子,请参见: 用法实例。 。 。 .
其他文档
- SQL 服务器设置指南: 连接到 SQL 服务器数据库的细节
- PostgreSQL 设置指南: 连接到 PostgreSQL 数据库的细节
- 用法实例: 与 Claude 一起使用的示例查询和命令
发展
要以开发模式运行服务器 :
npm run dev
注意开发过程中的变化:
npm run watch
所需资源
- 节点.js 18+
- 用于 SQL 服务器连接: SQL 服务器 2012年或以后
- 用于 PostgreSQL 连接: PostgreSQL 9.5 或以后
许可证
麻省理工学院