WRG MCP Server

Um servidor que fornece ferramentas para geração e visualização de recuo de armas por meio de endpoints HTTP.

Documentação

logo Weapon Recoil Generator – crie seu próprio MCP de recuo

  • Lançamos um servidor MCP versátil que permite que desenvolvedores de jogos FPS gerem e visualizem padrões de recuo de armas por meio de chamadas de API simples.
  • FPS 게임 개발자가 간단한 API 호출만으로 무기 반동 패턴을 생성하고 시각화할 수 있는 강력한 MCP 서버를 출시했습니다.

Saiba mais e implante no Smithery: smithery badge

WRG MCP Server

  • Este servidor MCP fornece duas ferramentas principais—Geração de Recuo de Arma e Visualização de Recuo—expostas como endpoints HTTP. Basta implantar localmente ou na nuvem e começar a ajustar o comportamento de recuo do seu jogo em tempo real.
  • 이 MCP 서버는 ‘무기 반동 생성’과 ‘반동 시각화’라는 두 가지 핵심 도구를 HTTP 엔드포인트로 제공하며, 로컬 또는 클라우드에 배포한 뒤 실시간으로 반동 튜닝을 시작할 수 있습니다.

Instalação

git clone https://github.com/Hyeongseob91/mcp-server.git
cd mcp-server
pip install -r requirements.txt

Development

Run the server locally with automatic reload: 자동 리로드 기능을 켜고 로컬에서 서버를 실행합니다:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

Uso

Configurar no Claude Desktop

Adicione ao seu arquivo de configuração do Claude: Claude 설정 파일에 다음을 추가하세요:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "wrg": {
      "command": "python /path/to/mcp-server/main.py --http"
    }
  }
}

Após reiniciar o Claude Desktop, você pode chamar os endpoints /wrg e /rvz diretamente. Claude Desktop을 재시작한 후 /wrg와 /rvz 엔드포인트를 직접 호출할 수 있습니다.

Principais Recursos

  • Geração de Recuo de Arma (WRG)

    • machinegun_recoil_points(shots: int)

      • Gera dados de trajetória de recuo para uma metralhadora com base no número de disparos.
      • 기관총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.
  • Geração de Recuo de Arma (WRG)

    • pistol_recoil_points(shots: int)

      • Gera dados de trajetória de recuo para uma pistola com base no número de disparos.
      • 권총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.
  • Geração de Recuo de Arma (WRG)

    • shotgun_recoil_points(shots: int)

      • Gera dados de trajetória de recuo para uma espingarda com base no número de disparos.
      • 산탄총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.
  • Visualizador de Recuo (RVZ)

    • plot_recoil_pattern(data: Tuple[List[float], List[float]])

      • Visualiza dados de coordenadas de recuo inseridos como um gráfico de dispersão 2D.
      • 입력된 반동 좌표 데이터를 2D 산점도로 시각화합니다.
  • Endpoints MCP

    • /wrg/* – acesso HTTP fácil para gerar dados de recuo.
    • /rvz/* – acesso HTTP instantâneo para visualizar padrões de recuo.
  • Implantação Remota e Local

    • Implante a mesma API em máquinas locais e ambientes de nuvem (ex.: Smithery) usando FastMCP.
    • FastMCP를 사용하여 로컬 및 클라우드(예: Smithery) 환경에 동일한 API를 배포합니다.
  • Autenticação por Chave de API (Planejado)

    • Suporte futuro para chaves de API para controlar o acesso externo.
    • 외부 접근 제어를 위한 API Key 인증 기능을 곧 지원할 예정입니다.

Benefícios Esperados

  1. Aumento de Produtividade

    • Não é necessário implementar algoritmos complexos de recuo por conta própria.
    • 복잡한 반동 알고리즘을 직접 구현할 필요가 없습니다.
    • Acelera a validação de dados e a prototipagem com ferramentas de visualização integradas.
    • 내장된 시각화 도구로 데이터 검증 및 프로토타입 속도가 향상됩니다.
  2. Colaboração e Reutilização Aprimoradas

    • Interfaces unificadas /wrg e /rvz facilitam o compartilhamento e a reutilização de módulos entre membros da equipe.
    • 통합된 /wrg 및 /rvz 인터페이스로 팀 간 모듈 공유 및 재사용이 용이합니다.
    • Funciona perfeitamente entre engenheiros de backend, frontend, IA e desenvolvedores de jogos.
    • 백엔드, 프론트엔드, AI 엔지니어, 게임 개발자 간 원활하게 연동됩니다.
  3. Implantação e Escalabilidade Flexíveis

    • Teste localmente e depois implante na nuvem para escalar sob demanda.
    • 로컬 테스트 후 클라우드에 배포하여 필요에 따라 손쉽게 확장할 수 있습니다.
    • Integra-se a pipelines de CI/CD para implantação automatizada e gerenciamento de versões.
    • CI/CD 파이프라인과 연동하여 자동 배포 및 버전 관리가 가능합니다.
  4. Feedback e Ajuste em Tempo Real

    • Verifique instantaneamente os padrões de recuo por meio de chamadas de API durante os ajustes de equilíbrio do jogo.
    • 게임 밸런스 조정 시 API 호출로 즉시 반동 패턴을 확인할 수 있습니다.
    • A tomada de decisão baseada em dados melhora a eficiência dos play-tests.
    • 데이터 기반 의사결정으로 플레이 테스트 효율성이 향상됩니다.

Depuração

  • Como este servidor se comunica via HTTP, use o log detalhado e o sinalizador de recarga integrado. Para uma inspeção mais profunda, anexe um depurador ao processo Uvicorn ou revise as saídas de erro do console.
  • 이 서버는 HTTP로 통신하므로, 자세한 로깅과 --reload 플래그를 사용하세요. 보다 심층적인 검사를 위해 Uvicorn 프로세스에 디버거를 연결하거나 콘솔 오류 출력을 확인하면 됩니다.