Advertise
MCP.so
Sign In

Click MCP Server

@crowecawcaw

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

crowecawcaw

About Click MCP Server

Turn click CLIs into MCP servers with one line of code

Click MCP Server config

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

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

Click MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

What are the dependencies or runtime requirements?

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

3

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")`.

4

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.

5

How are nested commands named when exposed as MCP tools?

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

Comments

More Other MCP servers

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

MCP Toolbox for Databases

googleapis

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

15.9K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K
Advertise