copr-mcp

# Copr MCP # Demo Please see the [First look at the Copr MCP server](https://www.youtube.com/watch?v=3gYktJT-Cr0). [](https://www.youtube.com/watch?v=3gYktJT-Cr0) ## Prerequisites Install dependencies ```console 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 ```console $ claude mcp add copr --scope user \ -- uv run --directory "$(pwd)" python main.py ``` If you don't need this MCP server anymore, uninstall it. ```console $ claude mcp remove copr ``` ### Codex ```console $ codex mcp add copr -- uv run --directory "$(pwd)" python main.py ``` If you don't need this MCP server anymore, uninstall it. ```console $ 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. ```json { "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 <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd>. Then type `>MCP: Open User Configuration`. The file `mcp.json` that opens should look something like this: ```json { "servers": {} } ``` Add the copr MCP server like so: ```json { "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 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>I</kbd>. Then type the following and press <kbd>Enter</kbd>: ``` 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: ```console $ export ANTHROPIC_API_KEY=... ``` Then run ```console $ uv run main.py --prompt "Tell me the status of Copr build 8101723" ``` To use a different model pass `--model` ```console $ 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 ```console $ uv run mypy . $ uv run ruff check $ uv run pytest ```