SQL Server元数据工具

MCP SQL Server是一款专为SQL Server设计的元数据分析和自动化文档工具,支持AI代理(如GitHub Copilot)直接连接SQL Server实例,进行数据库结构分析、存储过程检查和业务规则提取。

  • by BrunoFelipeSouza
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 BrunoFelipeSouza/MCP-Sql-Server

使用说明

MCP SQL Server

模型上下文协议(MCP)服务器 致力于SQL Server。
它为人工智能代理(GitHub Copilot,Claude等)展示元数据工具,程序分析,业务规则提取和自动文档。


概览

O MCP SQL Server 将任何 MCP 客户端(如 GitHub Copilot Coding Agent)直接连接到 SQL Server 实例,允许 AI 代理:

  • 列出数据库、表、视图、过程、函数和触发器。
  • 检查方案(列,类型,PK,FK,索引,约束)。
  • 读取任何编程对象(SP,UDF,触发器)的源代码。
  • 分析对象之间的直接和反向依赖关系。
  • 执行过程的静态分析(事务,光标,动态SQL,MERGE模式…)。
  • 搜索整个银行程序代码中的术语。
  • 执行任意 SELECT 查询(只读)。

可用工具

工具 描述
execute_query 运行 SELECT 查询并返回结果。
list_databases 列出所有用户数据库
get_server_info 版本、服务器名称和当前银行
list_tables 列出带有架构过滤器的表格。
get_table_schema 元数据(提示、PK、FK、身份、计算、MS_Description)
get_indexes 一个表的索引。
get_foreign_keys 外国钥匙和级联股票
list_views 定义的视图列表
list_triggers 列出具有定义和事件的触发器
list_procedures SP和函数列表
get_procedure_definition 完整的源代码和参数
get_procedure_dependencies 程序参考的对象
get_reverse_dependencies 谁叫这个物体?
analyze_procedure 静态分析:事务,光标,动态SQL,MERGE…
get_check_constraints CHECK constraints(约束的业务规则)
get_extended_properties MS_Description 和自定义属性
search_in_procedures 按术语搜索所有程序体。

安装

先决条件

  • Node.js≥18
  • 访问 SQL Server 实例(Express、Developer、Standard 或 Enterprise)

1. 克隆仓库

git clone https://github.com/BrunoFelipeSouza/MCP-Sql-Server.git
cd MCP-Sql-Server

2. 安装依赖关系

npm install

3. 设置连接

cp .env.example .env
# Edite o arquivo .env com os dados da sua instância SQL Server

4.建造

npm run build

5.执行

npm start

在VS Code / GitHub Copilot中配置MCP服务器

添加到您的 MCP 配置文件 (.vscode/mcp.json 哦 ~/.config/github-copilot/mcp.json):

{
  "servers": {
    "sql-server": {
      "type": "stdio",
      "command": "node",
      "args": ["/caminho/para/MCP-Sql-Server/dist/index.js"],
      "env": {
        "SQL_SERVER": "localhost",
        "SQL_DATABASE": "meu_banco",
        "SQL_USER": "sa",
        "SQL_PASSWORD": "SuaSenha",
        "SQL_PORT": "1433",
        "SQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

Github Copilot特工

此仓库在文件夹中包含两个专门的代理 .github/agents/:

🧠 敏捷天才(prompt-genius)

致力于改进和创建完美提示,用于 GitHub Copilot Agents 的代理。
分析需求,识别模糊性,并生成结构化和有效的提示。

🔍 SQL Server逆向工程(sql-server-reverse-engineer)

SQL Server 专家代理使用此 MCP 工具:

  • 从存储过程中提取业务规则
  • 识别汽车漏洞和反模式
  • 程序逻辑的Gerar流动图
  • 记录完整的数据库
  • 分析依赖关系和变化影响

查看文件夹 .github/agents/ 了解更多详情。


环境变量

变量 标准 描述
SQL_SERVER localhost 主机做SQL Server
SQL_DATABASE master 标准数据库
SQL_USER – 登录SQL Server
SQL_PASSWORD 登录密码
SQL_PORT 1433 Porta TCP
SQL_ENCRYPT false 启用 TLS/SSL。
SQL_TRUST_SERVER_CERTIFICATE true 信任自签名证书
SQL_WINDOWS_AUTH false 使用 Windows 身份验证 (NTLM)

开发

# Modo watch (recompila automaticamente)
npm run watch

# Lint
npm run lint

# Testes
npm test

许可证

麻省 理工© 布鲁诺·费利佩·苏扎