Rxresume MCP

🚀 rxresume-mcp

rxresume-mcp 是一個圍繞 Reactive Resume REST API 的小型 MCP 包裝器，可使用 MCP 工具來操作簡歷。

🚀 快速開始

📦 PyPI 包（標準輸入輸出）

要求：Python 3.11 及以上版本。

pip install rxresume-mcp

配置你的 MCP 客戶端以運行已安裝的控制檯腳本：

將以下內容添加到你的 MCP 客戶端配置中（標準輸入輸出傳輸）。一些客戶端（如 Cursor）可能需要將 uv 指向項目路徑，這種情況下在 args 中包含 --project /absolute/path/to/rxresume-mcp。

mcp.json

可將此作為 MCP 客戶端配置（標準輸入輸出傳輸）的起點。

{
  "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>"
      }
    }
  }
}

如果你想手動運行以進行調試：

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

🐳 Docker 鏡像（可流式傳輸的 HTTP）

運行從 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

📂 本地源碼（開發模式）

有關本地克隆的快速啟動說明，請參閱 DEVELOPING.md。

💻 MCP 客戶端示例（標準輸入輸出）

可將此作為 MCP 客戶端配置（標準輸入輸出傳輸）的起點。

{
  "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 示例（注意 --project 路徑）：

{
  "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>"
      }
    }
  }
}

🐋 使用 Docker Compose 快速啟動

同時啟動 Reactive Resume（及其依賴項）和 MCP 服務器：

docker compose up --build

服務正常運行後，MCP 服務器將在端口 8000 上可用，應用將在端口 3000 上可用。

⚙️ 開發

有關完整的開發說明，請參閱 DEVELOPING.md。快速啟動命令如下：

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