Thetabird MCP Server Axiom Js

🚀 Axiom-based MCP Server

This is a JavaScript version of the official Axiom MCP Server, which allows AI agents to query data through 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 implementation of the Axiom MCP Server, facilitating integration in Node.js environments.
• Provides the same functionality as the original Go version.
• Allows AI agents to query data using Axiom Processing Language (APL).

📦 Installation

MCP Configuration

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

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

Local Development and Testing

Installation

npm install -g mcp-server-axiom

Environment Variables

The server can be configured via 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): Query limit per second (Default: 1).
• AXIOM_QUERY_BURST (Optional): Query burst capacity (Default: 1).
• AXIOM_DATASETS_RATE (Optional): Dataset list operations per second (Default: 1).
• AXIOM_DATASETS_BURST (Optional): Dataset list burst capacity (Default: 2).
• 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

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.

Tool Call Examples

Query APL

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

List Datasets

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

📄 License

MIT