使用说明
MCP数据库工具
通过与AI助手的自然语言对话执行MySQL、Redis、ClickHouse和SQLite命令。
特性
- MySQL -执行SQL查询和修改
- 瑞迪斯 -执行Redis命令
- ClickHouse -执行ClickHouse SQL语句
- SQLite -执行SQLite SQL(基于文件或在内存中)
- SSH隧道 -通过SSH堡垒主机连接到数据库
安装
需求
- 达到1.21或更高
- MCP客户端(Claude Code、Cursor、Cline等)
步骤1:安装工具
go install github.com/comcpwork/mcp/cmd/cowork-database@latest
步骤2:配置MCP客户端
克劳德代码
添加MCP服务器:
claude mcp add database -- cowork-database database
光标/鼠标/其他MCP客户端
添加到MCP配置文件中:
{
"mcpServers": {
"database": {
"command": "cowork-database",
"args": ["database"]
}
}
}
配置文件位置:
- 克劳德桌面(macOS):
~/Library/Application Support/Claude/claude_desktop_config.json - 克劳德桌面(Windows):
%APPDATA%\Claude\claude_desktop_config.json - 光标: 设置>功能>MCP服务器
- 临床(VS代码):
.vscode/mcp.json或VS代码设置
步骤3:重新启动客户端
重新启动MCP客户端以加载数据库工具。
快速开始
问你的AI助手:
- MySQL: “使用DSN执行MySQL
root:password@tcp(localhost:3306)/testSQL:SELECT * FROM users" - Redis: “执行Redis命令
PING上redis://localhost:6379/0" - ClickHouse: “使用DSN执行ClickHouse
clickhouse://default:@localhost:9000/defaultSQL:SELECT 1" - SQLite: “使用DSN执行SQLite
:memory:SQL:SELECT 1"
DSN格式
| 数据库 | 格式 | 示例 |
|---|---|---|
| MySQL | user:pass@tcp(host:port)/dbname |
root:password@tcp(localhost:3306)/mydb |
| Redis | redis://[:password@]host:port/db |
redis://localhost:6379/0 |
| ClickHouse | clickhouse://user:pass@host:port/db |
clickhouse://default:@localhost:9000/default |
| SQLite | /path/to/file.db 或 :memory: |
/data/mydb.db 或 :memory: |
SSH连接
所有工具都支持可选的SSH隧道 ssh 参数。
SSH URI格式
| 格式 | 示例 | 说明 |
|---|---|---|
| 配置参考 | ssh://myserver |
使用 ~/.ssh/config 入口 |
| 密码验证 | ssh://user:pass@host:port |
直接密码验证 |
| 密钥认证 | ssh://user@host?key=/path/to/key |
私钥身份验证 |
示例
{
"dsn": "root:password@tcp(10.0.0.100:3306)/mydb",
"sql": "SELECT * FROM users",
"ssh": "ssh://admin@jump.example.com?key=~/.ssh/id_rsa"
}
注: SQLite使用远程命令执行模式(需要
sqlite3在远程服务器上)。
文档
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。