axm-mcp 0.1.0

AXM MCP Server — Runtime execution for the axm-protocols ecosystem

axm-mcp — MCP server for the axm-protocols ecosystem

---

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
• 📋 List tools — Built-in meta-tool to list all available tools and descriptions

Installation

uv add axm-mcp

With all AXM tools:

uv add "axm-mcp[all]"

Quick Start

# Start the MCP server
axm-mcp

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

MCP Tools

Tool	Package	Description
list_tools	built-in	List all available tools
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_doi	axm-bib	Resolve DOI → BibTeX
bib_pdf	axm-bib	Download paper PDF
bib_extract	axm-bib	Extract text from PDF

Development

git clone https://github.com/axm-protocols/axm-mcp.git
cd axm-mcp
uv sync --all-groups
uv run pytest           # 68 tests
uv run ruff check src/  # lint

License

Apache License 2.0