Demo

Please see the First look at the Copr MCP server.

Demo

Prerequisites

Install dependencies

uv sync

MCP Usage

Register the MCP server with Claude Code, Codex, Cursor, or any other agent.

Claude Code

To register the copr server with Claude Code, execute this command

$ claude mcp add copr --scope user \
    -- uv run --directory "$(pwd)" python main.py

If you don't need this MCP server anymore, uninstall it.

$ claude mcp remove copr

Codex

$ codex mcp add copr -- uv run --directory "$(pwd)" python main.py

If you don't need this MCP server anymore, uninstall it.

$ codex mcp remove copr

Cursor

If you use Cursor, open or create ~/.cursor/mcp.json and add the copr entry to the list of mcpServers.

Change the directory (~/src/copr-mcp) to wherever you've cloned this copr-mcp project.

{
  "mcpServers": {
    "copr": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "~/src/copr-mcp",
        "python",
        "main.py"
      ]
    }
  }
}

If you don't need this MCP server anymore, removing the copr entry from the mcpServers list in ~/.cursor/mcp.json.

Visual Studio Code

Open the Command Palette in VSCode by pressing Ctrl+Shift+P. Then type >MCP: Open User Configuration. The file mcp.json that opens should look something like this:

{
	"servers": {}
}

Add the copr MCP server like so:

{
  "servers": {
    "copr": {
      "type": "local",
      "command": "uvx",
      "args": ["--from", "git+https://github.com/fedora-copr/copr-mcp@main", "--verbose", "copr-mcp-server"]
    }
  }
}

Save the file (~/.config/Code/mcp.json) and start the server by hitting the little "Save" link that appears right above the line with "copr": {.

Test the server by opening the Chat view with Ctrl+Alt+I. Then type the following and press Enter:

Use copr_list_mock_chroots from the copr MCP server and list all supported mock chroots.

You should see a Run copr_list_mock_chroots copr (MCP Server) followed by some text and a button that says Allow in this Session.

If you don't need this MCP server anymore, remove the copr entry from the servers list in the MCP: Open User Configuration (~/.config/Code/mcp.json).

Run tools

Once the MCP server is registered, go to i.e. Claude or Cursor and ask it questions like

Tell me the status of Copr build 8101723

Can you give me last 5 builds from the frostyx/foo Copr project?

Build the DistGit package hello in my frostyx/foo project

Create a Copr project frostyx/foo with a fedora-43-x86_64 chroot

Development

Go to https://console.anthropic.com, "API Keys" and generate a new key. Then export it in your terminal:

$ export ANTHROPIC_API_KEY=...

Then run

$ uv run main.py --prompt "Tell me the status of Copr build 8101723"

To use a different model pass --model

$ uv run main.py --model gpt-5-mini --prompt "Tell me the status of Copr build 8101723"

Full list of models can be found here: https://pydantic.dev/docs/ai/api/models/base/#pydantic_ai.models.KnownModelName

Tests

$ uv run mypy .
$ uv run ruff check
$ uv run pytest