MSSQL

🚀 MSSQL MCP 服務器

一個用於連接到 Microsoft SQL Server 數據庫的 Model Context Protocol (MCP) 服務器。此服務器提供了執行 SQL 查詢和管理數據庫連接的工具，能幫助用戶更便捷地操作數據庫。

版本說明：此項目已升級為使用 Model Context Protocol SDK 1.9.0。有關詳細信息，請參閱 UPGRADE.md。

🚀 快速開始

本項目提供了便捷的安裝方式，讓你能快速使用 MSSQL MCP 服務器。

📦 安裝指南

使用 Smithery 進行安裝

通過 Smithery 自動安裝 MSSQL MCP 服務器以供 Claude 桌面使用：

npx -y @smithery/cli install @c0h1b4/mssql-mcp-server --client claude

手動安裝

npm install mssql-mcp-server

💻 使用示例

基礎用法

將服務器添加到您的 MCP 設置配置文件中：

{
  "mcpServers": {
    "mssql": {
      "command": "mssql-mcp-server",
      "env": {
        "MSSQL_CONNECTION_STRING": "Server=localhost;Database=master;User Id=sa;Password=yourpassword;",
        // 或者單獨的連接參數：
        "MSSQL_HOST": "localhost",
        "MSSQL_PORT": "1433",
        "MSSQL_DATABASE": "master",
        "MSSQL_USER": "sa",
        "MSSQL_PASSWORD": "yourpassword",
        "MSSQL_ENCRYPT": "false",
        "MSSQL_TRUST_SERVER_CERTIFICATE": "true"
      }
    }
  }
}

高級用法

query 工具

在 MSSQL 數據庫上執行 SQL 查詢。

參數

要麼提供 connectionString，要麼同時提供 (host + username + password)。

示例

const result = await use_mcp_tool({
  server_name: 'mssql',
  tool_name: 'query',
  arguments: {
    host: 'localhost',
    username: 'sa',
    password: 'yourpassword',
    query: 'SELECT * FROM Users',
  },
});

🔧 技術細節

運行服務器

本地開發

# 安裝依賴項
npm install

# 以開發模式運行
npm run dev

# 構建
npm run build

# 運行構建後的服務器
npm start

使用 Docker

# 構建並啟動服務（SQL Server + MCP 服務器）
docker-compose up

# 或者僅構建 Docker 鏡像
docker build -t mssql-mcp-server .

測試

# 運行測試
npm test

# 帶覆蓋率的測試
npm run test:coverage

安全

服務器包含防止危險 SQL 操作的安全措施：

• 阻止執行潛在危害的操作，如 DROP、TRUNCATE、ALTER、CREATE、EXEC 等。
• 驗證所有輸入參數和數據庫名稱的有效性。
• 設置合理的查詢長度和超時限制。
• 使用連接池以提高性能和安全性。

📄 許可證

本項目採用 MIT 許可證。