Weapon Recoil Generator – build your own recoil MCP

by Hyeongseob91

198 downloads Not rated yet

About

A server providing tools for weapon recoil generation and visualization via HTTP endpoints.

Explore

Weapon Recoil Generation (WRG)

machinegun_recoil_points(shots: int)

Generates recoil trajectory data for a machine gun based on the number of shots.
기관총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.

Weapon Recoil Generation (WRG)

pistol_recoil_points(shots: int)

Generates recoil trajectory data for a pistol based on the number of shots.
권총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.

Weapon Recoil Generation (WRG)

shotgun_recoil_points(shots: int)

Generates recoil trajectory data for a shotgun based on the number of shots.
산탄총 발사 횟수에 따른 반동 궤적 데이터를 생성합니다.

Recoil Visualizer (RVZ)

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

Visualizes input recoil coordinate data as a 2D scatter plot.
입력된 반동 좌표 데이터를 2D 산점도로 시각화합니다.

MCP Endpoints

/wrg/ – easy HTTP access to generate recoil data.
/rvz/ – instant HTTP access to visualize recoil patterns.

Remote & Local Deployment

Deploy the same API to both local machines and cloud environments (e.g., Smithery) using FastMCP.
FastMCP를 사용하여 로컬 및 클라우드(예: Smithery) 환경에 동일한 API를 배포합니다.

API Key Authentication (Planned)

Upcoming support for API keys to control external access.
* 외부 접근 제어를 위한 API Key 인증 기능을 곧 지원할 예정입니다.

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

Add to your Claude config:
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"
    }
  }
}

After restarting Claude Desktop, you can call the /wrg and /rvz` endpoints directly.
Claude Desktop을 재시작한 후 /wrg와 /rvz 엔드포인트를 직접 호출할 수 있습니다.

We released a versatile MCP server that lets FPS game developers generate and visualize weapon recoil patterns via simple API calls.
FPS 게임 개발자가 간단한 API 호출만으로 무기 반동 패턴을 생성하고 시각화할 수 있는 강력한 MCP 서버를 출시했습니다.

Learn more and deploy on Smithery: smithery badge

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.