本地DB MCP服务器
一个MCP(模型上下文协议)服务器,使AI助手能够查询Microsoft SQL server本地数据库(MSSQLLocalDB)并与之交互。
特性
此MCP服务器提供以下工具:
| 工具 | 说明 |
|---|---|
list_databases | 列出本地数据库实例上的所有数据库 |
connect_database | 连接到特定数据库 |
list_tables | 列出当前数据库中的所有表 |
describe_table | 获取详细的架构信息(列、键、索引) |
query | 执行SELECT查询(只读,安全) |
execute_sql | 执行任何SQL语句(INSERT、UPDATE、DELETE、DDL) |
database_info | 获取数据库元数据和统计信息 |
list_stored_procedures | 列出所有存储过程 |
get_procedure_definition | 获取存储过程的源代码 |
sample_data | 从表中获取示例行 |
先决条件
- Node.js 18或更高版本
- 已安装Microsoft SQL Server本地数据库
- 名为的本地数据库实例
MSSQLLocalDB(默认)
安装
npm install
npm run build用法
使用VS代码(GitHub Copilot)
这 .vscode/mcp.json 文件已配置。只需打开此目录中的VS Code,MCP服务器即可使用。
使用克劳德桌面
将此添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"localdb-mcp": {
"command": "node",
"args": ["d:/MCP HOLE/localdb-mcp/build/index.js"]
}
}
}手动测试
npm start查询示例
连接后,您可以询问您的AI助手:
- “列出本地数据库上的所有数据库”
- “连接到AdventureWorks数据库”
- “显示当前数据库中的所有表”
- “描述客户表”
- “显示Orders表的前10行”
- “产品表中有多少条记录?”
- “此数据库中存在哪些存储过程?”
安全说明
- 这
query出于安全考虑,该工具只允许SELECT语句 - 这
execute_sql该工具允许任何SQL语句,请谨慎使用 - 默认情况下,连接使用Windows身份验证
- 仅连接到本地计算机上的本地数据库
发展
# Watch mode for development
npm run dev
# Build for production
npm run build故障排除
连接问题
- 确保安装了本地数据库:
sqllocaldb info- 如果未运行,请启动MariaDB实例:
sqllocaldb start MSSQLLocalDB- 验证实例是否可访问:
sqllocaldb info MSSQLLocalDB常见错误
- “无法连接到本地数据库”:确保MSSQLLocalDB实例存在并且正在运行
- “登录失败”:本地数据库使用Windows身份验证-确保您有访问权限
- “找不到数据库”:使用
list_databases查看可用数据库
许可证
麻省理工学院
