JinDaGe - rxresume-mcp MCP Details

article

README

🚀 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

rxresume-mcp