数据库交互服务

LocalDB MCP Server是一个使AI助手能够查询和与Microsoft SQL Server LocalDB交互的模型上下文协议服务器。

  • by sam2332
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 sam2332/localdb-mcp

使用说明

本地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

故障排除

连接问题

  1. 确保安装了本地数据库:

    sqllocaldb info
    
  2. 如果未运行,请启动MariaDB实例:

    sqllocaldb start MSSQLLocalDB
    
  3. 验证实例是否可访问:

    sqllocaldb info MSSQLLocalDB
    

常见错误

  • “无法连接到本地数据库”:确保MSSQLLocalDB实例存在并且正在运行
  • “登录失败”:本地数据库使用Windows身份验证-确保您有访问权限
  • “找不到数据库”:使用 list_databases 查看可用数据库

许可证

麻省理工学院