# PyCLI MCP

| | |
| --- | --- |
| CI/CD | [![CI - Test](https://github.com/ofek/pycli-mcp/actions/workflows/test.yml/badge.svg)](https://github.com/ofek/pycli-mcp/actions/workflows/test.yml) [![CD - Build](https://github.com/ofek/pycli-mcp/actions/workflows/build.yml/badge.svg)](https://github.com/ofek/pycli-mcp/actions/workflows/build.yml) |
| Docs | [![Docs](https://github.com/ofek/pycli-mcp/actions/workflows/docs.yml/badge.svg)](https://github.com/ofek/pycli-mcp/actions/workflows/docs.yml) |
| Package | [![PyPI - Version](https://img.shields.io/pypi/v/pycli-mcp.svg?logo=pypi&label=PyPI&logoColor=gold)](https://pypi.org/project/pycli-mcp/) [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pycli-mcp.svg?logo=python&label=Python&logoColor=gold)](https://pypi.org/project/pycli-mcp/) |
| Meta | [![Hatch project](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/pypa/hatch/master/docs/assets/badge/v0.json)](https://github.com/pypa/hatch) [![linting - Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![License - MIT](https://img.shields.io/badge/license-MIT-9400d3.svg)](https://spdx.org/licenses/) [![GitHub Sponsors](https://img.shields.io/github/sponsors/ofek?logo=GitHub%20Sponsors&style=social)](https://github.com/sponsors/ofek) |

-----

This provides an extensible [MCP](https://modelcontextprotocol.io) server that is compatible with any Python command line application.

Supported frameworks:

- [Click](https://github.com/pallets/click)
- [Typer](https://github.com/fastapi/typer)
- [Argparse](https://docs.python.org/3/library/argparse.html) (experimental support)

## Installation

```console
pip install pycli-mcp
```

## Documentation

The [documentation](https://ofek.dev/pycli-mcp/) is made with [Material for MkDocs](https://github.com/squidfunk/mkdocs-material) and is hosted by [GitHub Pages](https://docs.github.com/en/pages).

## License

`pycli-mcp` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.