MCP Server Axiom Js

🚀 Axiom 的 MCP 服務器

這是一個基於 JavaScript 的 官方 Axiom MCP 服務器 的端口，允許 AI 代理通過 Axiom Processing Language (APL) 查詢數據。此實現提供了與原版 Go 版本相同的功能，但作為 npm 模塊打包，便於在 Node.js 環境中集成。

🚀 快速開始

本項目是 Axiom 的 MCP 服務器的 JavaScript 端口，可讓 AI 代理通過 APL 查詢數據，且便於在 Node.js 環境集成。

✨ 主要特性

• 基於 JavaScript 實現，是官方 Axiom MCP 服務器的端口。
• 允許 AI 代理通過 APL 查詢數據。
• 功能與原版 Go 版本相同，以 npm 模塊打包，方便在 Node.js 環境集成。

📦 安裝指南

MCP 配置

你可以直接通過 npx 運行這個 MCP 服務器。將以下配置添加到你的 MCP 配置文件中：

{
  "axiom": {
    "command": "npx",
    "args": ["-y", "mcp-server-axiom"],
    "env": {
      "AXIOM_TOKEN": "<YOUR_AXIOM_TOKEN_HERE>",
      "AXIOM_URL": "https://api.axiom.co",
      "AXIOM_ORG_ID": "<YOUR_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（可選）：數據集列表突發容量（默認：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
}

💻 使用示例

基礎用法

工具調用示例

1. 查詢 APL：

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

2. 列出數據集：

curl -X POST http://localhost:3000/tools/listDatasets/call

📚 詳細文檔

API 端點

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

📄 許可證

此項目使用 MIT 許可證。