Redshift MCP Server (typescript) Xqy

🚀 Amazon Redshift MCP 服務器（TypeScript）

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

🚀 快速開始

與 MCP 客戶端集成

項目特定配置

在項目目錄中創建一個 .cursor/mcp.json 文件，示例配置如下：

{
  "mcpServers": {
    "redshift-mcp": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "env": {
        "DATABASE_URL": "redshift://username:password@hostname:port/database?ssl=true"
      }
    }
  }
}

全局配置

若要在所有項目中使用，可在主目錄創建 ~/.cursor/mcp.json 文件，配置內容相同。

客戶端特定設置

Cursor IDE

1. 若在 mcp.json 中配置了該服務器，會自動檢測。
2. 工具將在“可用工具”部分顯示。
3. 代理會在相關內容出現時自動使用這些工具。

其他 MCP 客戶端

使用 stdio 傳輸配置服務器，示例如下：

{
  "servers": [
    {
      "name": "redshift-mcp",
      "transport": {
        "kind": "stdio",
        "command": ["node", "path/to/dist/index.js"]
      }
    }
  ]
}

先決條件

• Node.js 16 或更高版本
• TypeScript
• 對 Amazon Redshift 集群的訪問權限
• Redshift 和 SQL 的基礎知識
• 安裝了 Cursor IDE

安裝

1. 克隆此倉庫或將文件複製到本地系統。
2. 安裝依賴項：

npm install

3. 編譯 TypeScript 代碼：

npm run build

使用方法

服務器需要通過 DATABASE_URL 環境變量提供，示例命令如下：

DATABASE_URL=redshift://username:password@hostname:port/database?ssl=true npm start

其中：

• username：Redshift 用戶名
• password：Redshift 密碼
• hostname：Redshift 服務器地址
• port：端口（默認為 5432）
• database：要連接的數據庫名稱

💻 使用示例

基礎用法

啟動服務器：

DATABASE_URL=redshift://myuser:mypassword@redshift-cluster-1.c1234567890.us-east-1.redshift.amazonaws.com:5432/mydb?ssl=true npm start

之後可在 http://localhost:4000 訪問 API 文檔。

📚 詳細文檔

開發

在開發時，可使用 npm run dev 命令，該命令使用 ts - node 直接運行 TypeScript 代碼，無需預編譯。

延伸閱讀

有關 MCP 協議的更多信息，請參考 MCP Protocol Documentation。