Thetabird MCP Server Axiom Js

🚀 AxiomベースのMCPサーバー

このプロジェクトは、公式のAxiom MCPサーバーのJavaScriptバージョンです。AIエージェントがAxiomを通じて言語（APL）でデータをクエリすることを可能にします。

この実装は、元のGo言語版と同じ機能を提供しますが、npmモジュールとしてパッケージ化されているため、Node.js環境での統合が容易です。

🚀 クイックスタート

このセクションでは、AxiomベースのMCPサーバーのインストールと使用方法を説明します。

✨ 主な機能

• AIエージェントがAxiomを通じてAPLでデータをクエリできる。
• 元のGo言語版と同じ機能を持ち、npmモジュールとして提供される。
• Node.js環境での統合が容易。

📦 インストール

MCP設定

npxを使ってこのMCPサーバーを直接実行できます。以下の設定をあなたの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）
• AXIOM_QUERY_BURST（任意）：クエリのバースト容量（デフォルト：1）
• AXIOM_DATASETS_RATE（任意）：データセットリスト操作の毎秒（デフォルト：1）
• AXIOM_DATASETS_BURST（任意）：データセットリストのバースト容量（デフォルト：2）
• 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エンドポイントを使った基本的な使用例です。

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ライセンスの下で公開されています。