MCP Server Axiom Js

🚀 Axiom's MCP Server

This is a JavaScript-based port of the official Axiom MCP server, allowing AI agents to query data through the Axiom Processing Language (APL).

This implementation offers the same functionality as the original Go version but is packaged as an npm module for easy integration in a Node.js environment.

🚀 Quick Start

✨ Features

• A JavaScript port of the official Axiom MCP server.
• Allows AI agents to query data via APL.
• Packaged as an npm module for seamless Node.js integration.

📦 Installation

MCP Configuration

You can run this MCP server directly via npx. Add the following configuration to your MCP configuration file:

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

Local Development and Testing

Installation

npm install -g mcp-server-axiom

Environment Variables

The server can be configured through environment variables:

• AXIOM_TOKEN (Required): Your Axiom API token.
• AXIOM_ORG_ID (Required): Your Axiom organization ID.
• AXIOM_URL (Optional): Custom Axiom API URL (default: https://api.axiom.co).
• AXIOM_QUERY_RATE (Optional): Queries per second limit (default: 1).
• AXIOM_QUERY_BURST (Optional): Query burst capacity (default: 1).
• AXIOM_DATASETS_RATE (Optional): Datasets list operation limit per second (default: 1).
• AXIOM_DATASETS_BURST (Optional): Datasets list burst capacity (default: 1).
• PORT (Optional): Server port (default: 3000).

Running the Server Locally

1. Using environment variables:

export AXIOM_TOKEN=your_token
mcp-server-axiom

2. Using a configuration file:

mcp-server-axiom config.json

Example config.json:

{
  "token": "your_token",
  "url": "https://custom.axiom.co",
  "orgId": "your_org_id",
  "queryRate": 2,
  "queryBurst": 5,
  "datasetsRate": 1,
  "datasetsBurst": 2
}

💻 Usage Examples

Basic Usage

API Endpoints

• GET /: Get server implementation information.
• GET /tools: List available tools.
• POST /tools/:name/call: Call a specific tool.
  • Available tools:
    • queryApl: Execute an APL query.
    • listDatasets: List available datasets.

Advanced Usage

Tool Call Examples

1. Query APL:

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

2. List Datasets:

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

📄 License

This project is licensed under the MIT License.