SQL数据库协议服务器

一个基于Model Context Protocol (MCP)的服务器,用于与Microsoft SQL Server (MSSQL)交互,提供查询、插入、更新、删除等数据库操作功能。

  • by VenkaiahChowdarycns
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 VenkaiahChowdarycns/Mssql-mcp-server

使用说明

Microsoft SQL MCP工具服务器

该项目提供了 模型上下文协议(MCP) 用于交互的服务器 Microsoft SQL Server(MSSQL).
它使用[fastmcp]作为MCP服务器框架,它公开了用于常见数据库操作的工具,例如:

  • 运行SQL查询
  • 插入行
  • 更新数据
  • 删除记录
  • 正在检查数据库运行状况
  • 获取表架构详细信息

特性

  • ✅ 执行任何有效的MSSQL查询
  • ✅ 动态插入、更新和删除记录
  • ✅ 检索表架构和元数据
  • ✅ 检查数据库连接健康状况
  • ✅ 专为实时MCP交互而设计
  • ✅ 与无缝协作 邮递员MCP,或任何与MCP兼容的客户端

Python版本依赖关系

  • 工作:Python 3.14

安装

  1. 克隆存储库并导航到其中:

    git clone <repo_url>
    cd mssql-mcp-server
    
  2. 创建虚拟环境:

   python -m venv venv
   venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt

项目结构

mssql-mcp-server/
├── server.py
├── db.py
├── tools/
│   ├── mssql_query.py
│   ├── mssql_insert.py
│   ├── mssql_update.py
│   ├── mssql_delete.py
│   ├── mssql_schema.py
│   
├── .env
└── requirements.txt

MSSQL连接配置

MSSQL_SERVER=localhost
MSSQL_DATABASE=YourDatabaseName
MSSQL_USER=YourUsername
MSSQL_PASSWORD=YourPassword
MSSQL_DRIVER=ODBC Driver 17 for SQL Server

可用的MCP工具

工具名称 描述 参数
insert 执行任何自定义SQL查询 table: str, data: [str, Any]
update 更新现有数据 table: str, data: [str, Any], condition: [str, Any]
query 执行任何自定义SQL查询 query: str, params: Optional[List[Any]]
delete 从表中删除记录 table: str, condition: [str, Any]
schema 检索特定表的架构 table_name: str

运行MCP服务器

python server.py

服务器将在以下位置使用流式http传输运行:

http://127.0.0.1:8080

使用Postman进行测试

  1. Open Postman(支持MCP的最新版本)。
  2. 单击新建→ MCP请求。
  3. 输入MCP服务器URL:
http://127.0.0.1:8080/mcp
  1. 单击“连接”。
  2. 现在,您将看到“消息”块中自动列出的所有可用工具(mssql_query_tool、mssql_insert_tool、msgql_update_tool、msaql_delete_tool、mssql_schema_tool、mspql_health_tool)。
  3. 选择一个工具并提供所需的输入参数。
  4. 运行请求--您将从连接的Microsoft SQL Server获得实时响应。

无需手动制作原始JSON——Postman MCP会自动为您列出可用的工具并格式化。