Redshift Js MCP Server

🚀 亞馬遜 Redshift MCP 服務器（TypeScript）

這是一個用 TypeScript 編寫的針對 Amazon Redshift 實現的 Model Context Protocol (MCP) 服務器。它遵循 Anthropic 的實現模式，能為 Cursor IDE 和其他 MCP 兼容客戶端提供豐富的數據庫上下文信息，讓大型語言模型 (LLMs) 可以查看數據庫架構並執行只讀查詢。

🚀 快速開始

集成與 MCP 客戶端

項目特定配置

在項目目錄中創建一個 .cursor/mcp.json 文件：

{
  "mcpServers": {
    "redshift-mcp": {
      "command": "node",
      "args": ["src/index.ts"],
      "env": {
        "DATABASE_URL": "redshift://user:password@host:port/database"
      }
    }
  }
}

全局配置

在全局目錄中創建 .cursor/mcp.json：

{
  "mcpServers": {
    "redshift-mcp": {
      "command": "node",
      "args": ["src/index.ts"],
      "env": {
        "DATABASE_URL": "redshift://user:password@host:port/database"
      }
    }
  }
}

📦 安裝指南

使用以下命令安裝依賴項並構建項目：

npm install
npm run build

對於開發環境，可以使用以下命令直接運行 TypeScript 文件：

npm run dev

🏗️ 項目結構

• src/index.ts：項目的主入口文件，負責啟動服務器和服務請求。
• tsconfig.json：TypeScript 配置文件。
• package.json：項目依賴和腳本定義。

✨ 主要特性

工具實現

1. 查詢執行 (query)：
   • 執行任意 SQL 查詢並返回結果。
   • 支持複雜的查詢操作，如聯合、聚合等。
2. 表結構描述 (describe_table)：
   • 返回指定表格的列信息，包括數據類型和約束。
   • 例如：DESCRIBE customers
3. 表查找 (find_tables)：
   • 根據關鍵字或模式搜索表格。
   • 支持模糊查詢和正則表達式。
4. 樣本數據 (sample_data)：
   • 返回指定表格的樣例數據行，幫助用戶瞭解數據內容。
   • 自動紅action敏感信息（如電子郵件、電話號碼）。

資源定義

• Schema Listings：列出數據庫中的所有模式。
• Table Schemas：返回特定表格的詳細架構信息。
• Sample Data：提供指定表格的樣例數據行。

⚠️ 安全注意事項

1. 輸入 sanitization：防止 SQL 注入和其他惡意請求。
2. 紅action敏感數據：在樣本數據中隱藏敏感信息，如電子郵件和電話號碼。
3. SSL 連接：通過 SSL 確保與數據庫的通信安全。

💻 使用示例

以下是用戶可以在 Cursor 中提出的一些示例問題：

1. "顯示公共模式中的所有表格"
2. "customers 表的結構是什麼？"
3. "查找包含客戶信息的所有表格"
4. "編寫一個按狀態統計訂單數量的查詢"
5. "顯示 products 表的樣例數據"

🔧 技術細節

功能擴展

1. 新增資源類型：定義新的資源類型並實現其處理邏輯。
2. 自定義工具：添加更多功能，如高級查詢分析或數據導出。
3. 增強安全性：實施身份驗證和訪問控制機制。

開發建議

• 使用環境變量管理敏感信息，避免硬編碼。
• 通過日誌記錄和監控工具跟蹤服務器狀態和請求情況。
• 定期測試和更新依賴項，確保系統的安全性和穩定性。