Alkemi MCP

🚀 Alkemi MCP Server

Alkemi MCP Server 可將你連接到 Snowflake、Google BigQuery、DataBricks 等數據源的 Alkemi 數據與 MCP 客戶端集成。它是可流式傳輸的 HTTP MCP 端點的標準輸入輸出（STDIO）包裝器，端點地址如下：

https://api.alkemi.cloud/mcp

你可以在 datalab.alkemi.ai 獲取免費的 API 密鑰。

🚀 快速開始

通過本服務器，你能夠將各類數據源中的 Alkemi 數據與 MCP 客戶端集成，實現數據的高效查詢與共享。

✨ 主要特性

數據集成

Alkemi MCP Server 可集成連接到 Snowflake、Google BigQuery、DataBricks 等數據源的 Alkemi 數據，與 MCP 客戶端無縫對接。

知識存儲與查詢優化

在查詢數據庫時，需要了解表結構和查詢示例，否則可能得到錯誤結果。Alkemi MCP Server 利用 Alkemi 存儲數據庫元數據、生成合適的查詢語句並實際查詢數據庫，方便團隊共享數據，確保每個人都能進行高質量的查詢。

多環境支持

支持在 MacOS 和 Windows 系統上進行安裝配置，可通過環境變量靈活配置服務器。

📦 安裝指南

添加服務器配置

要將 OpenAI 添加到 Claude Desktop，需添加服務器配置：

• MacOS：配置文件路徑為 ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：配置文件路徑為 %APPDATA%/Claude/claude_desktop_config.json

環境變量

• MCP_NAME：MCP 服務器的名稱，可選。若配置多個服務器，此變量為必填項，以確保在 MCP 客戶端中名稱不重複。
• BEARER_TOKEN：可流式傳輸的 HTTP MCP 服務器的令牌，是 STDIO MCP 集成的必填項。
• PRODUCT_ID：若要將範圍限定在單個產品，可設置此產品 ID，可選。

配置示例

使用 npx

可在 Claude Desktop 配置中通過 npx 使用：

{
  "mcpServers": {
    "alkemi": {
      "command": "npx",
      "args": [
        "@alkemiai/alkemi-mcp"
      ],
      "env": {
        "BEARER_TOKEN": "sk-12345"
      }
    }
  }
}

克隆倉庫後使用

若克隆倉庫，可在 Claude Desktop 配置中構建並使用：

{
  "mcpServers": {
    "alkemi-data": {
      "command": "node",
      "args": [
        "/path/to/alkemi-mcp/build/index.js"
      ],
      "env": {
        "BEARER_TOKEN": "sk-12345"
      }
    }
  }
}

指定產品和多個配置

若要指定 MCP 服務器使用的特定產品，可設置 PRODUCT_ID 環境變量。通過設置 MCP_NAME，還可配置多個服務器：

{
  "mcpServers": {
    "alkemi-customer-data": {
      "command": "node",
      "args": [
        "/path/to/alkemi-mcp/build/index.js"
      ],
      "env": {
        "MCP_NAME": "customer-data",
        "PRODUCT_ID": "123",
        "BEARER_TOKEN": "sk-12345"
      }
    },
    "alkemi-web-traffic-data": {
      "command": "node",
      "args": [
        "/path/to/alkemi-mcp/build/index.js"
      ],
      "env": {
        "MCP_NAME": "web-traffic-data",
        "PRODUCT_ID": "234",
        "BEARER_TOKEN": "sk-12345"
      }
    }
  }
}

🔧 技術細節

開發步驟

安裝依賴

npm install

構建服務器

npm run build

開發時自動重建

npm run watch

調試

由於 MCP 服務器通過標準輸入輸出進行通信，調試可能具有挑戰性。建議使用 MCP Inspector，可通過以下命令運行：

npm run inspector

Inspector 將提供一個 URL，可在瀏覽器中訪問調試工具。

致謝

感謝 modelcontextprotocol 和 Anthropic 團隊提供的 MCP 規範以及將其集成到 Claude Desktop 的工作。詳情請見 https://modelcontextprotocol.io/introduction。