conda-cli-mcp#

conda-cli-mcp exposes the command line of one installed conda through the Model Context Protocol (MCP). It discovers conda and plugin commands at server startup, generates structured tools where argparse metadata is sufficient, and keeps every command reachable through raw argv when explicitly enabled.

Conda still performs configuration loading, plugin ordering, solving, transactions, authentication, command hooks, and error handling. The MCP server runs conda in bounded child processes without invoking a shell.

Note

This project is alpha software.

Choose a documentation path#

Tutorial

Connect an MCP client to a read-only server and inspect the discovered conda interface.

Connect a read-only conda server
How-to guides

Install from Anaconda.org, select a target conda, set limits, enable operations, and refresh tools after plugin changes.

Install with conda
Reference

Look up server options, MCP tools, resources, schemas, and result fields.

Server command-line reference
Explanation

Understand parser discovery, process isolation, plugin participation, and the safety model.

Architecture and plugin participation

Supported target#

The server requires Python 3.10 or newer and is tested on Linux, macOS, and Windows. The selected target must provide conda >=26.7,<27. The server and target conda installation may live in different Python environments when --conda-exe identifies the target explicitly.