Alkemi Mcp

Alkemi MCP 服务

将连接到 Snowflake、Google BigQuery、DataBricks 和其他数据源的 Alkemi 数据与您的 MCP 客户端集成。

这是 Streamable HTTP MCP 端点的 STDIO 包装器：

https://api.alkemi.cloud/mcp

在 datalab.alkemi.ai 免费获取 API 密钥

Alkemi.ai

查询数据库需要了解表的架构，也可能需要一些示例，说明哪些查询可以回答特定问题。否则，您可能会得到错误答案。在每个查询数据库的 Agent 或 MCP 客户端中维护所有这些信息是一项挑战，而且对于希望共享数据的团队来说，这种做法无法扩展。

Alkemi MCP 服务使用 Alkemi 存储数据库元数据、生成合适的查询并实际查询数据库，因此您可以与队友共享 MCP 服务，让每个人都能以相同的质量进行查询。

安装

要将 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：Streamable HTTP MCP 服务的 Bearer 令牌。STDIO MCP 集成必须设置此项。
• PRODUCT_ID：如果您想将范围限定为单个产品，请填写该产品的 ID。此项为可选。

配置

您可以在 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 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它作为软件包脚本提供：

npm run inspector

Inspector 会提供一个 URL，供您在浏览器中访问调试工具。

致谢

• 显然要感谢 modelcontextprotocol 和 Anthropic 团队制定 MCP 规范并将其集成到 Claude Desktop 中。https://modelcontextprotocol.io/introduction