Alkemi MCP

🚀 Alkemi MCP Server

AlkemiのデータをSnowflake、Google BigQuery、DataBricksなどのソースに接続し、MCPクライアントと統合します。

これはStreamable HTTP MCPエンドポイントのSTDIOラッパーです：

https://api.alkemi.cloud/mcp

datalab.alkemi.ai で無料のAPIキーを取得してください。

🚀 クイックスタート

Alkemi MCP Serverを使用することで、Alkemiのデータを様々なソースと接続し、MCPクライアントと統合できます。以下のセクションでは、その詳細な使い方やインストール方法を説明します。

✨ 主な機能

Alkemi.aiについて

データベースをクエリするには、テーブルのスキーマに関する知識が必要であり、特定の質問に答えることができるクエリの種類の例が必要になる場合があります。そうでないと、間違った答えを得る可能性があります。データベースをクエリするすべてのエージェントまたはMCPクライアントでそのような情報を維持することは困難であり、データを共有しようとするチームにはスケーラブルではありません。

Alkemi MCP ServerはAlkemiを使用してデータベースのメタデータを保存し、適切なクエリを生成し、実際にデータベースをクエリするため、MCP Serverをチームメイトと共有することができ、誰もが同じ品質でクエリを実行することができます。

📦 インストール

OpenAIをClaude Desktopに追加する場合

Claude DesktopにOpenAIを追加するには、サーバー設定を追加します。

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

環境変数

• MCP_NAME: MCP Serverの名前。オプションです。複数のサーバーを構成する場合は、MCPクライアント内で名前が重複しないようにこの設定が必要です。
• BEARER_TOKEN: Streamable HTTP MCP Serverのベアラートークン。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 Serverが使用するように指定したい場合は、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

インスペクターは、ブラウザでデバッグツールにアクセスするためのURLを提供します。

謝辞

• もちろん、MCP仕様とClaude Desktopへの統合に関してmodelcontextprotocolとAnthropicチームに感謝します。https://modelcontextprotocol.io/introduction