MSSQL MCP Server

這是一個自定義的 Model Context Protocol (MCP) 伺服器，用於連接 Microsoft SQL Server。它可以讓您的 AI 助手（如 Claude Desktop 或 Cursor）直接查詢資料庫結構、讀取資料或執行 SQL 指令。

安裝與設定

1. 安裝 ODBC Driver for SQL Server

此 MCP 伺服器需要 Microsoft ODBC Driver 17 或 18 for SQL Server 來支援 Always Encrypted 功能。

下載連結：https://learn.microsoft.com/en-us/sql/connect/odbc/download-odbc-driver-for-sql-server

安裝後，可以在命令提示字元執行以下指令確認：

    odbcad32

在「驅動程式」標籤中應該可以看到「ODBC Driver 17 for SQL Server」或「ODBC Driver 18 for SQL Server」。

1. 安裝依賴

在當前目錄下執行：

    npm install

1. 設定環境變數

複製 .env.example 為 .env，並填入您的資料庫連線資訊：

    cp .env.example .env

編輯 .env 檔案：

    DB_USER=sa
    DB_PASSWORD=您的密碼
    DB_SERVER=localhost
    DB_DATABASE=您的資料庫名稱
    DB_PORT=1433
    DB_ENCRYPT=true
    DB_TRUST_SERVER_CERTIFICATE=true

在 Claude Desktop 中使用

編輯您的 Claude Desktop 設定檔 (通常位於 %APPDATA%\Claude\claude_desktop_config.json)，新增以下內容：

{
  "mcpServers": {
    "mssql": {
      "command": "node",
      "args": ["D:/MCP/MSSQL_MCP/index.js"]
    }
  }
}

功能

此 MCP 伺服器提供以下功能：

Resources (資源)

• mssql://{schema}/{table}: 讀取指定資料表的前 100 筆資料。
• 例如: mssql://dbo/Users

Tools (工具)

• list_tables: 列出資料庫中所有的資料表。
• 參數 (可選): schema (篩選架構), limit (限制筆數)
• get_table_schema: 查詢指定資料表的欄位結構。
• 參數: tableName (例如 "dbo.Users")
• execute_query: 執行任意 T-SQL 指令 (SELECT, INSERT, UPDATE, DELETE)。
• 參數: query (例如 "SELECT * FROM Users WHERE ID = 1")

安全性注意事項

• 此伺服器允許執行任意 SQL 指令，請確保不要在生產環境中隨意執行破壞性指令 (DROP, DELETE 等)。
• 請勿將包含密碼的 .env 檔案提交到版本控制系統。

Always Encrypted 支援限制

此 MCP 伺服器使用 Node.js 的 mssql 套件（基於 Tedious 驅動），目前無法解密 SQL Server Always Encrypted 欄位。

查詢包含 Always Encrypted 欄位的資料表時，加密欄位會顯示為 [ENCRYPTED - Always Encrypted column cannot be decrypted by Node.js mssql driver]。

如需查詢加密欄位的實際內容，請使用：

• SQL Server Management Studio (SSMS)
• Azure Data Studio
• 支援 Always Encrypted 的 .NET 應用程式
• 其他支援 Always Encrypted 的資料庫工具