https://github.com/axiomhq/mcp-server-axiom
Axiom Model Context Protocol Server
https://github.com/axiomhq/mcp-server-axiom
Last synced: about 2 months ago
JSON representation
Axiom Model Context Protocol Server
- Host: GitHub
- URL: https://github.com/axiomhq/mcp-server-axiom
- Owner: axiomhq
- License: mit
- Created: 2024-12-05T13:06:26.000Z (5 months ago)
- Default Branch: master
- Last Pushed: 2024-12-06T20:38:23.000Z (5 months ago)
- Last Synced: 2025-03-19T10:54:35.104Z (about 2 months ago)
- Language: Go
- Size: 21.5 KB
- Stars: 19
- Watchers: 5
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Axiom - Analyze logs, traces, and operational data using natural language (🏢 Enterprise-Supported Implementations / Data & Web Services)
- awesome-mcp-servers - Axiom - Analyze logs, traces, and operational data using natural language (🏢 Enterprise-Supported Implementations / Data & Web Services)
- awesome-mcp-zh - Axiom
- awesome-mcp - Axiom - <img src="./images/languages/python.svg" > Query and analyze logs, traces, and event data using natural language using Axiom Processing Language (APL). (Mcp Servers / monitor)
- awesome-mcp - Axiom - <img src="./images/languages/python.svg" > Query and analyze logs, traces, and event data using natural language using Axiom Processing Language (APL). (Mcp Servers / monitor)
- Awesome-MCP-Servers-directory - Axiom - Query and analyze your Axiom logs, traces, and all other event data in natural language (Data Science Tools)
- awesome-mcp-servers - Axiom - Axiom Model Context Protocol Server (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Axiom - Axiom Model Context Protocol Server (Table of Contents / Other Tools and Integrations)
- awesome-mcp-servers - Axiom - Query and analyze your Axiom logs, traces, and all other event data in natural language (Official Servers)
README
# mcp-server-axiom
A [Model Context Protocol](https://modelcontextprotocol.io/) server implementation for [Axiom](https://axiom.co) that enables AI agents to query your data using Axiom Processing Language (APL).
## Status
Works with Claude desktop app. Implements two MCP [tools](https://modelcontextprotocol.io/docs/concepts/tools):
- queryApl: Execute APL queries against Axiom datasets
- listDatasets: List available Axiom datasets
No support for MCP [resources](https://modelcontextprotocol.io/docs/concepts/resources) or [prompts](https://modelcontextprotocol.io/docs/concepts/prompts) yet.
## Installation
### Releases
Download the latest built binary from the [releases page](https://github.com/axiomhq/axiom-mcp/releases).
### Source
```bash
go install github.com/axiomhq/axiom-mcp@latest
```
## Configuration
Configure using one of these methods:
### Config File Example (config.txt):
```txt
token xaat-your-token
url https://api.axiom.co
query-rate 1
query-burst 1
datasets-rate 1
datasets-burst 1
```
### Command Line Flags:
```bash
axiom-mcp \
-token xaat-your-token \
-url https://api.axiom.co \
-query-rate 1 \
-query-burst 1 \
-datasets-rate 1 \
-datasets-burst 1
```
### Environment Variables:
```bash
export AXIOM_TOKEN=xaat-your-token
export AXIOM_URL=https://api.axiom.co
export AXIOM_ORG_ID=your-org-id
export AXIOM_QUERY_RATE=1
export AXIOM_QUERY_BURST=1
export AXIOM_DATASETS_RATE=1
export AXIOM_DATASETS_BURST=1
```
## Usage
1. Create a config file:
```bash
echo "token xaat-your-token" > config.txt
```
2. Configure the Claude app to use the MCP server:
```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
```json
{
"mcpServers": {
"axiom": {
"command": "/path/to/your/axiom-mcp-binary",
"args" : ["--config", "/path/to/your/config.txt"],
"env": { // Alternatively, you can set the environment variables here
"AXIOM_TOKEN": "xaat-your-token",
"AXIOM_URL": "https://api.axiom.co",
"AXIOM_ORG_ID": "your-org-id"
}
}
}
}
```
## License
MIT License - see LICENSE file