Rxresume MCP

🚀 rxresume-mcp

Reactive ResumeのREST APIをラップした小さなMCPツールです。MCPツールを使って履歴書を操作することができます。

🚀 クイックスタート

PyPIパッケージ (stdio)

必要条件: Python 3.11以上。

pip install rxresume-mcp

インストールしたコンソールスクリプトを実行するようにMCPクライアントを設定します。

MCPクライアントの設定（stdioトランスポート）に以下を追加します。一部のクライアント（Cursorなど）では、uvをプロジェクトパスに向ける必要がある場合があります。その場合は、argsに--project /absolute/path/to/rxresume-mcpを含めてください。

mcp.json

MCPクライアントの設定（stdioトランスポート）の起点としてこれを使用します。

{
  "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イメージ (streamable 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クライアントの例 (stdio)

MCPクライアントの設定（stdioトランスポート）の起点としてこれを使用します。

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