Skip to main content
No installation needed! Run MCI directly using uvx
bash curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Initialize a new project: 
    uvx mcix install
    This creates mci.json with example tools and mci/ directory with example toolsets.
  2. List your tools: 
    uvx mcix list
uvx mcix list --file copilot.mci.json
    Example output: alt text
  3. Validate your configuration: 
    uvx mcix validate
  4. Run an MCP server: 
    uvx mcix run
    Example from VS Code: alt text
That’s it! Your MCI tools are now available via the MCP protocol.

​
Optional: Install MCI Globally

If you prefer to install MCI permanently: 
# Install globally with uv
uv tool install mcix

# Then use without uvx prefix
mcix install
mcix list
mcix run
Or install from source: 
git clone https://github.com/Model-Context-Interface/mci-uvx.git
cd mci-uvx
uv sync --all-extras
uv tool install --editable .

​
Next Steps

Now that you have MCI set up, explore these core concepts:

Commands

Learn about all available MCI commands and their options.

Tools

Understand how to define and use tools in your MCI configuration.

Toolsets

Organize your tools into reusable toolsets.

MCP Servers

Learn how MCI integrates with the Model Context Protocol.