# Copilot MCP Server

This (horrible horrible) project provides MCP servers that wrap the `copilot` CLI so third-party MCP clients can invoke Copilot through tools.

## Exposed tools

- `copilot_prompt`: Runs `copilot -p "<prompt>"` in non-interactive mode.
  - Supports session continuity:
    - `session_id` -> `--session-id <id>`
    - `resume_session` -> `--resume=<id-or-name>`
    - `continue_session=true` -> `--continue`
  - Exactly one session mode can be selected per call.
- `copilot_command`: Runs general `copilot ...` commands (interactive/server flags are blocked).

Tool return structured output with:

- `ok`
- `command`
- `exit_code` (when executed)
- `stdout`
- `stderr`

## Requirements

- `copilot` CLI installed and authenticated
- Python 3.10+ (for Python server)

Optionally set `COPILOT_BIN` if `copilot` is not in PATH.

## Python setup

```bash
git clone ...
uv init .
uv --directory . run copilot_mcp_server.py 
```

Run:

```bash
copilot-mcp-server
```

## Example MCP client config

Python server:

```json
{
  "mcpServers": {
    "copilot-as-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "~/Copilot-as-MCP",
        "run",
        "copilot_mcp_server.py"
      ]
    }
  }
}
```

## Session examples

- Continue with a known session ID:
  - `copilot_prompt(prompt="Refine the previous answer", session_id="...")`
- Resume by session/task identifier:
  - `copilot_prompt(prompt="Continue this task", resume_session="...")`
- Continue most recent session:
  - `copilot_prompt(prompt="Continue", continue_session=true)`