Thetabird MCP Server Axiom Js

🚀 基於Axiom的MCP服務器

這是一個基於Axiom的MCP服務器的JavaScript版本，它源自官方的Axiom MCP服務器。該服務器允許AI代理通過Axiom處理語言（APL）來查詢數據，為數據查詢提供了便捷的解決方案。此實現以npm模塊的形式打包，具備與原版Go語言實現相同的功能，方便在Node.js環境中集成使用。

🚀 快速開始

本服務器允許AI代理通過Axiom處理語言（APL）查詢數據，並且以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
}

💻 使用示例

基礎用法

工具調用示例

查詢APL

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

列出數據集

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

📚 詳細文檔

API端點

• GET /：獲取服務器實現信息
• GET /tools：列出可用工具
• POST /tools/:name/call：調用特定工具
  • 可用工具：
    • queryApl：執行APL查詢
    • listDatasets：列出可用數據集

📄 許可證

本項目採用MIT許可證。