Rxresume MCP

🚀 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 the following 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.

💻 Usage Examples

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