rxresume-mcp

A small MCP wrapper around the Reactive Resume REST API. Use it to manipulate resumes using MCP tools.

Quick start

PyPI package (stdio)

Requirements: Python 3.11+.

pip install rxresume-mcp

Configure your MCP client to run the installed console script:

Add this to your MCP client config (stdio transport). Some clients (like Cursor) may require uv to be pointed at the project path, in which case include --project /absolute/path/to/rxresume-mcp in the args.

mcp.json

Use this as a starting point for your MCP client configuration (stdio transport).

{
  "mcpServers": {
    "rxresume": {
      "command": "uv",
      "args": ["run", "rxresume-mcp", "--mcp-transport", "stdio"],
      "env": {
        "APP_URL": "https://rxresu.me",
        "REST_API_KEY": "your-rxresume-api-key",
        "REST_API_TIMEOUT": "30",
        "REST_API_USER_AGENT": "rxresume-mcp/<package version>"
      }
    }
  }
}

If you want to run it manually for debugging:

APP_URL="http://localhost:3000" REST_API_KEY="rxresume-key" rxresume-mcp --mcp-transport stdio

Docker image (streamable HTTP)

Run the published image from GHCR:

docker run --rm -p 8000:8000 \
  -e APP_URL="http://localhost:3000" \
  -e REST_API_KEY="rxresume-key" \
  ghcr.io/a-earthperson/rxresume-mcp:latest

Local source (dev)

For a local clone quickstart, see DEVELOPING.md.

MCP client example (stdio)

Use this as a starting point for your MCP client configuration (stdio transport).

{
  "mcpServers": {
    "rxresume": {
      "command": "uv",
      "args": ["run", "rxresume-mcp", "--mcp-transport", "stdio"],
      "env": {
        "APP_URL": "https://rxresu.me",
        "REST_API_KEY": "your-rxresume-api-key",
        "REST_API_TIMEOUT": "30",
        "REST_API_USER_AGENT": "rxresume-mcp/<package version>"
      }
    }
  }
}

Cursor example (note the --project path):

{
  "mcpServers": {
    "rxresume": {
      "command": "uv",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/rxresume-mcp",
        "rxresume-mcp",
        "--mcp-transport",
        "stdio"
      ],
      "env": {
        "APP_URL": "https://rxresu.me",
        "REST_API_KEY": "your-rxresume-api-key",
        "REST_API_TIMEOUT": "30",
        "REST_API_USER_AGENT": "rxresume-mcp/<package version>"
      }
    }
  }
}

Quick start with Docker Compose

Spin up Reactive Resume (plus dependencies) and the MCP server together:

docker compose up --build

Once healthy, the MCP server is available on port 8000 and the app on 3000.

Development

For full development instructions, see DEVELOPING.md. Quick start:

uv sync --extra dev
uv run ruff check src
uv run pytest