Overview
This repository provides an extensible MCP server that is compatible with any Python command line application. The MCP server supports multiple CLI frameworks, including Click, Typer, and experimental Argparse, enabling developers to expose their command-line tools to the Model Context Protocol. It is installable via pip, and the project’s documentation is built with Material for MkDocs and hosted on GitHub Pages. The repository ships under the MIT license and includes CI/CD workflows for testing, building, and documenting. Designed to be framework-agnostic, the PyCLI MCP server aims to simplify integrating local Python CLIs with the MCP ecosystem without requiring rewrites of existing applications.
Features
Extensible MCP server
An extensible MCP server that works with any Python command-line application.
Framework compatibility: Click
Official support for the Click framework.
Framework compatibility: Typer
Official support for the Typer framework.
Framework compatibility: Argparse (experimental)
Experimental Argparse integration.
Installation via pip
Installable with a single pip install pycli-mcp.
Documentation
MkDocs-based documentation hosted on GitHub Pages.
MIT license
Open-source project licensed under the MIT license.
Who Is This For?
- Python CLI developers:Expose their command-line apps via MCP for external interaction and automation.
- Framework users (Click, Typer, Argparse):Leverage MCP to create MCP-enabled CLIs using their preferred frameworks.
