Skip to content

AXM Logo

axm-mcp

MCP server for the AXM ecosystem — runtime tool discovery and execution.

CI axm-audit Coverage PyPI

Features

  • 🔌 Auto-discovery — Finds all axm.tools entry points from installed packages
  • 🛠️ MCP bridge — Exposes discovered tools as Model Context Protocol callables
  • ✅ Verify — One-shot project quality check: audit + init check + AST enrichment
  • 🚀 HTTP transport — Optional persistent Streamable HTTP server (axm-mcp serve) for a single shared process across conversations

Installation

Bash
uv add axm-mcp          # core server
uv add "axm-mcp[all]"   # with all AXM tools

Quick Start

Bash
# Start the MCP server
axm-mcp

All installed AXM tools are immediately available to any MCP client.

MCP Tools

Tool Package Description
verify built-in One-shot audit + init check + AST enrichment
audit axm-audit Code quality audit (lint, types, complexity, security)
init_check axm-init 39 governance checks against AXM gold standard
init_scaffold axm-init Scaffold a new Python project
bib_search axm-bib Search academic papers by title
bib_resolve axm-bib Resolve a DOI/arXiv ref → BibTeX
bib_pdf axm-bib Download paper PDF
bib_extract axm-bib Extract text from PDF

Learn More