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。