MSSQL MCP Server

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

安裝與設定

安裝 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

安裝後，可以在命令提示字元執行以下指令確認： ``bash odbcad32 `` 在「驅動程式」標籤中應該可以看到「ODBC Driver 17 for SQL Server」或「ODBC Driver 18 for SQL Server」。

安裝依賴

在當前目錄下執行： ``bash npm install ``

設定環境變數

複製 .env.example 為 .env，並填入您的資料庫連線資訊： ``bash cp .env.example .env ` 編輯 .env 檔案： `ini 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 的資料庫工具

MSSQL MCP