Axiom 的 MCP 服务器

这是 官方 Axiom MCP 服务器 的 JavaScript 版本，它使 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（可选）：数据集列表突发容量（默认值：1）
• PORT（可选）：服务器端口（默认值：3000）

本地运行服务器

1. 使用环境变量：

export AXIOM_TOKEN=your_token
mcp-server-axiom

1. 使用配置文件：

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"
    }
  }'

1. 列出数据集：

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

许可证

MIT