Metadata-Version: 2.4
Name: axm-mcp
Version: 0.1.0
Summary: AXM MCP Server — Runtime execution for the axm-protocols ecosystem
Project-URL: Homepage, https://github.com/axm-protocols/axm-mcp
Project-URL: Documentation, https://axm-protocols.github.io/axm-mcp/
Project-URL: Repository, https://github.com/axm-protocols/axm-mcp.git
Project-URL: Issues, https://github.com/axm-protocols/axm-mcp/issues
Author-email: Gabriel Jarry <gabriel@axm-protocols.io>
License: Apache-2.0
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: axm
Requires-Dist: mcp[cli]>=1.25.0
Provides-Extra: all
Requires-Dist: axm-audit; extra == 'all'
Requires-Dist: axm-bib; extra == 'all'
Requires-Dist: axm-init; extra == 'all'
Provides-Extra: audit
Requires-Dist: axm-audit; extra == 'audit'
Provides-Extra: bib
Requires-Dist: axm-bib; extra == 'bib'
Provides-Extra: init
Requires-Dist: axm-init; extra == 'init'
Description-Content-Type: text/markdown

  AXM Logo

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

  Python 3.12+

---

## 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

```bash
uv add axm-mcp
```

With all AXM tools:

```bash
uv add "axm-mcp[all]"
```

## 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 |
|---|---|---|
| `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

```bash
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
