RequestRepo MCP

RequestRepo MCP

Servidor MCP para requestrepo por adragos.

Alcance

• Superficie completa de herramientas de requestrepo (solicitudes, uso compartido, DNS, archivos, ping)
• Transporte stdio por defecto, streamable-http opcional
• Mutaciones con confirmación obligatoria (confirm=true)
• Envoltura de bytes segura para JSON en campos binarios

La documentación completa de parámetros está en TOOLS.md.

Instalación

python -m pip install -e .

Para desarrollo local:

python -m pip install -e ".[dev]"

Configuración

• REQUESTREPO_TOKEN (opcional)
• REQUESTREPO_ADMIN_TOKEN (opcional)
• REQUESTREPO_HOST (por defecto requestrepo.com)
• REQUESTREPO_PORT (por defecto 443)
• REQUESTREPO_PROTOCOL (por defecto https)
• REQUESTREPO_VERIFY (por defecto true)
• REQUESTREPO_DEFAULT_TIMEOUT_SECONDS (por defecto 30)
• REQUESTREPO_MAX_BYTES (por defecto 65536)

Comportamiento de autenticación:

• Si REQUESTREPO_TOKEN está configurado, se utiliza.
• De lo contrario, se crea una nueva sesión, opcionalmente con REQUESTREPO_ADMIN_TOKEN.

Ejecución

requestrepo-mcp --transport stdio

requestrepo-mcp --transport streamable-http --host 127.0.0.1 --port 8000 --streamable-http-path /mcp

Instalación en Clientes de IA

Codex

Con token (opcional, recomendado si ya tienes uno):

codex mcp add requestrepo --env REQUESTREPO_TOKEN=your-token -- requestrepo-mcp --transport stdio

Sin token (crea una nueva sesión automáticamente):

codex mcp add requestrepo -- requestrepo-mcp --transport stdio

Verificar configuración:

codex mcp get requestrepo

Nota de inicio automático:

• Codex inicia los servidores stdio automáticamente.
• Si el inicio falla, regístralo con una ruta absoluta del ejecutable:

codex mcp add requestrepo --env REQUESTREPO_TOKEN=your-token -- /absolute/path/to/requestrepo-mcp --transport stdio

Claude Code / Claude Desktop

{
  "mcpServers": {
    "requestrepo": {
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "requestrepo": {
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

VS Code (Copilot Agent)

.vscode/mcp.json:

{
  "servers": {
    "requestrepo": {
      "type": "stdio",
      "command": "requestrepo-mcp",
      "args": ["--transport", "stdio"],
      "env": {
        "REQUESTREPO_TOKEN": "your-token"
      }
    }
  }
}

Resumen de Herramientas

• session_info
• list_requests
• wait_for_request
• delete_request
• delete_all_requests
• share_request
• get_shared_request
• list_dns
• add_dns
• remove_dns
• update_dns
• list_files
• get_file
• set_file
• update_files
• ping

Las herramientas de mutación requieren confirm=true.

Pruebas

pytest -q

CI ejecuta pruebas en push y pull requests (ver .github/workflows/ci.yml).