# MCP Server for Axiom A JavaScript port of the [official Axiom MCP server](https://github.com/axiomhq/mcp-server-axiom) that enables AI agents to query data using Axiom Processing Language (APL).

This implementation provides the same functionality as the original Go version but packaged as an npm module for easier integration with Node.js environments. ## Installation & Usage ### MCP Configuration You can run this MCP server directly using npx. Add the following configuration to your MCP configuration file: ```json { "axiom": { "command": "npx", "args": ["-y", "mcp-server-axiom"], "env": { "AXIOM_TOKEN": "", "AXIOM_URL": "https://api.axiom.co", "AXIOM_ORG_ID": "" } } } ``` ### Local Development & Testing #### Installation ```bash npm install -g mcp-server-axiom ``` #### Environment Variables The server can be configured using environment variables: - `AXIOM_TOKEN` (required): Your Axiom API token - `AXIOM_ORG_ID` (required): Your Axiom organization ID - `AXIOM_URL` (optional): Custom Axiom API URL (defaults to 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): Dataset list operations per second (default: 1) - `AXIOM_DATASETS_BURST` (optional): Dataset list burst capacity (default: 1) - `PORT` (optional): Server port (default: 3000) #### Running the Server Locally 1. Using environment variables: ```bash export AXIOM_TOKEN=your_token mcp-server-axiom ``` 2. Using a config file: ```bash mcp-server-axiom config.json ``` Example config.json: ```json { "token": "your_token", "url": "https://custom.axiom.co", "orgId": "your_org_id", "queryRate": 2, "queryBurst": 5, "datasetsRate": 1, "datasetsBurst": 2 } ``` ## API Endpoints - `GET /`: Get server implementation info - `GET /tools`: List available tools - `POST /tools/:name/call`: Call a specific tool - Available tools: - `queryApl`: Execute APL queries - `listDatasets`: List available datasets ### Example Tool Calls 1. Query APL: ```bash curl -X POST http://localhost:3000/tools/queryApl/call \ -H "Content-Type: application/json" \ -d '{ "arguments": { "query": "['logs'] | where ['severity'] == \"error\" | limit 10" } }' ``` 2. List Datasets: ```bash curl -X POST http://localhost:3000/tools/listDatasets/call \ -H "Content-Type: application/json" \ -d '{ "arguments": {} }' ``` ## License MIT 24:Taa1,# MCP Server for Axiom A JavaScript port of the [official Axiom MCP server](https://github.com/axiomhq/mcp-server-axiom) that enables AI agents to query data using Axiom Processing Language (APL).