MCP Server for Axiom

Axiom 的 MCP 服务

官方 Axiom MCP 服务的 JavaScript 移植版，使 AI Agent 能够使用 Axiom Processing Language (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（可选）：数据集列表突发容量（默认值：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