RequestRepo MCP

RequestRepo MCP

Servidor MCP para requestrepo por adragos.

Escopo

• Superfície completa da ferramenta requestrepo (requests, compartilhamento, DNS, arquivos, ping)
• Transporte padrão stdio, streamable-http opcional
• Mutações com confirmação obrigatória (confirm=true)
• Envelope de bytes seguro para JSON em campos binários

A documentação completa dos parâmetros está em TOOLS.md.

Instalação

python -m pip install -e .

Para desenvolvimento local:

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

Configuração

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

Comportamento de autenticação:

• Se REQUESTREPO_TOKEN estiver definido, ele será usado.
• Caso contrário, uma nova sessão é criada, opcionalmente com REQUESTREPO_ADMIN_TOKEN.

Execução

requestrepo-mcp --transport stdio

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

Instalação em Clientes de IA

Codex

Com token (opcional, recomendado se você já tiver um):

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

Sem token (cria uma nova sessão automaticamente):

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

Verificar configuração:

codex mcp get requestrepo

Nota sobre inicialização automática:

• O Codex inicia servidores stdio automaticamente.
• Se a inicialização falhar, registre com um caminho absoluto do executável:

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

Resumo das Ferramentas

• 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

Ferramentas de mutação exigem confirm=true.

Testes

pytest -q

O CI executa testes em pushes e pull requests (veja .github/workflows/ci.yml).