MCP Server for Axiom

Axiom 用 MCP サーバー

AI エージェントが Axiom Processing Language（APL）を使ってデータをクエリできるようにする、公式 Axiom MCP サーバーの JavaScript 版です。

この実装は、元の Go 版と同じ機能を提供しますが、Node.js 環境に簡単に統合できるよう npm モジュールとしてパッケージ化されています。

インストールと使用方法

MCP の設定

この MCP サーバーは npx を使って直接実行できます。MCP 設定ファイルに次の設定を追加してください。

{
  "axiom": {
    "command": "npx",
    "args": ["-y", "mcp-server-axiom"],
    "env": {
      "AXIOM_TOKEN": "<AXIOM_TOKEN_HERE>",
      "AXIOM_URL": "https://api.axiom.co",
      "AXIOM_ORG_ID": "<AXIOM_ORG_ID_HERE>"
    }
  }
}

ローカルでの開発とテスト

インストール

npm install -g mcp-server-axiom

環境変数

このサーバーは環境変数を使って設定できます。

• AXIOM_TOKEN（必須）：Axiom API トークン
• AXIOM_ORG_ID（必須）：Axiom 組織 ID
• AXIOM_URL（任意）：カスタム Axiom API URL（デフォルトは https://api.axiom.co）
• AXIOM_QUERY_RATE（任意）：1 秒あたりのクエリ数の上限（デフォルト：1）
• AXIOM_QUERY_BURST（任意）：クエリのバースト容量（デフォルト：1）
• AXIOM_DATASETS_RATE（任意）：1 秒あたりのデータセット一覧操作数（デフォルト：1）
• AXIOM_DATASETS_BURST（任意）：データセット一覧のバースト容量（デフォルト：1）
• PORT（任意）：サーバーのポート（デフォルト：3000）

サーバーをローカルで実行する

1. 環境変数を使用する場合：

export AXIOM_TOKEN=your_token
mcp-server-axiom

2. 設定ファイルを使用する場合：

mcp-server-axiom config.json

設定例（config.json）：

{
  "token": "your_token",
  "url": "https://custom.axiom.co",
  "orgId": "your_org_id",
  "queryRate": 2,
  "queryBurst": 5,
  "datasetsRate": 1,
  "datasetsBurst": 2
}

API エンドポイント

• GET /：サーバー実装情報を取得
• GET /tools：利用可能なツールを一覧表示
• POST /tools/:name/call：指定したツールを呼び出す
  • 利用可能なツール：
    • queryApl：APL クエリを実行
    • listDatasets：利用可能なデータセットを一覧表示

ツール呼び出しの例

1. APL のクエリ：

curl -X POST http://localhost:3000/tools/queryApl/call \
  -H "Content-Type: application/json" \
  -d '{
    "arguments": {
      "query": "['logs'] | where ['severity'] == \"error\" | limit 10"
    }
  }'

2. データセットの一覧表示：

curl -X POST http://localhost:3000/tools/listDatasets/call \
  -H "Content-Type: application/json" \
  -d '{
    "arguments": {}
  }'

ライセンス

MIT