MCP.so
Sign In

click-mcp

@crowecawcaw

Repository

About click-mcp

Turn click CLIs into MCP servers with one line of code

Basic information

Category

Other

License

MIT

Runtime

python

Transports

stdio

Publisher

crowecawcaw

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "click-mcp": {
      "command": "python",
      "args": [
        "my_app.py",
        "mcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is click-mcp?

click-mcp is a Python library that extends Click applications with Model Context Protocol (MCP) support, allowing AI agents to discover and interact with CLI tools programmatically. It provides a simple decorator that converts Click commands into MCP tools.

How to use click-mcp?

Install via pip (pip install click-mcp), then decorate your Click group with @click_mcp(). Run the MCP server using python my_app.py mcp (or a custom command name if configured). The decorator automatically converts Click commands into MCP tools with named parameters and dot‑notation for nested groups.

Key features of click-mcp

  • Simple @click_mcp decorator syntax
  • Automatic conversion of Click commands to MCP tools
  • Support for nested command groups
  • Support for positional arguments
  • Stdio‑based MCP server for easy integration

Use cases of click-mcp

  • Turn any existing Click CLI into an MCP‑compatible tool
  • Allow AI agents to invoke CLI commands with structured parameters
  • Expose complex nested command hierarchies as discoverable MCP tools

FAQ from click-mcp

What is the Model Context Protocol (MCP)?

MCP is an open standard for AI agents to interact with tools and applications in a structured way.

What are the dependencies or runtime requirements?

click-mcp requires Python and the Click library. The README assumes a standard Python environment.

How can I customize the MCP command name?

Use the command_name parameter in the @click_mcp decorator, e.g. @click_mcp(command_name="start-mcp").

How are command errors handled?

When a Click command raises an exception, click-mcp captures the error and returns it as part of the MCP response, enabling AI agents to handle errors gracefully.

How are nested commands named when exposed as MCP tools?

Nested commands use dot notation (e.g., users.create).

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

🪟 Windows-MCP

CursorTouch

MCP Server for Computer Use in Windows

6.3K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K