mcp-server

mcp-server

3.2

If you are the rightful owner of mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Weapon Recoil Generator (WRG) MCP server allows FPS game developers to generate and visualize weapon recoil patterns through simple API calls.

Weapon Recoil Generator โ€“ build your own recoil MCP

  • 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:

WRG MCP Server

  • This MCP server provides two core toolsโ€”Weapon Recoil Generation and Recoil Visualizationโ€”exposed as HTTP endpoints. Simply deploy locally or in the cloud and start tuning your gameโ€™s recoil behavior in real time.
  • ์ด MCP ์„œ๋ฒ„๋Š” โ€˜๋ฌด๊ธฐ ๋ฐ˜๋™ ์ƒ์„ฑโ€™๊ณผ โ€˜๋ฐ˜๋™ ์‹œ๊ฐํ™”โ€™๋ผ๋Š” ๋‘ ๊ฐ€์ง€ ํ•ต์‹ฌ ๋„๊ตฌ๋ฅผ HTTP ์—”๋“œํฌ์ธํŠธ๋กœ ์ œ๊ณตํ•˜๋ฉฐ, ๋กœ์ปฌ ๋˜๋Š” ํด๋ผ์šฐ๋“œ์— ๋ฐฐํฌํ•œ ๋’ค ์‹ค์‹œ๊ฐ„์œผ๋กœ ๋ฐ˜๋™ ํŠœ๋‹์„ ์‹œ์ž‘ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Installation

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

Usage

Configure in Claude Desktop

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 ์—”๋“œํฌ์ธํŠธ๋ฅผ ์ง์ ‘ ํ˜ธ์ถœํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

Key Features

  • 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 ์ธ์ฆ ๊ธฐ๋Šฅ์„ ๊ณง ์ง€์›ํ•  ์˜ˆ์ •์ž…๋‹ˆ๋‹ค.

Expected Benefits

  1. Productivity Boost

    • No need to implement complex recoil algorithms yourself.
    • ๋ณต์žกํ•œ ๋ฐ˜๋™ ์•Œ๊ณ ๋ฆฌ์ฆ˜์„ ์ง์ ‘ ๊ตฌํ˜„ํ•  ํ•„์š”๊ฐ€ ์—†์Šต๋‹ˆ๋‹ค.
    • Accelerates data validation and prototyping with built-in visualization tools.
    • ๋‚ด์žฅ๋œ ์‹œ๊ฐํ™” ๋„๊ตฌ๋กœ ๋ฐ์ดํ„ฐ ๊ฒ€์ฆ ๋ฐ ํ”„๋กœํ† ํƒ€์ž… ์†๋„๊ฐ€ ํ–ฅ์ƒ๋ฉ๋‹ˆ๋‹ค.
  2. Enhanced Collaboration & Reusability

    • Unified /wrg and /rvz interfaces make it easy for team members to share and reuse modules.
    • ํ†ตํ•ฉ๋œ /wrg ๋ฐ /rvz ์ธํ„ฐํŽ˜์ด์Šค๋กœ ํŒ€ ๊ฐ„ ๋ชจ๋“ˆ ๊ณต์œ  ๋ฐ ์žฌ์‚ฌ์šฉ์ด ์šฉ์ดํ•ฉ๋‹ˆ๋‹ค.
    • Works seamlessly across backend, frontend, AI engineers, and game developers.
    • ๋ฐฑ์—”๋“œ, ํ”„๋ก ํŠธ์—”๋“œ, AI ์—”์ง€๋‹ˆ์–ด, ๊ฒŒ์ž„ ๊ฐœ๋ฐœ์ž ๊ฐ„ ์›ํ™œํ•˜๊ฒŒ ์—ฐ๋™๋ฉ๋‹ˆ๋‹ค.
  3. Flexible Deployment & Scaling

    • Test locally, then deploy to the cloud for on-demand scaling.
    • ๋กœ์ปฌ ํ…Œ์ŠคํŠธ ํ›„ ํด๋ผ์šฐ๋“œ์— ๋ฐฐํฌํ•˜์—ฌ ํ•„์š”์— ๋”ฐ๋ผ ์†์‰ฝ๊ฒŒ ํ™•์žฅํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • Integrates with CI/CD pipelines for automated deployment and version management.
    • CI/CD ํŒŒ์ดํ”„๋ผ์ธ๊ณผ ์—ฐ๋™ํ•˜์—ฌ ์ž๋™ ๋ฐฐํฌ ๋ฐ ๋ฒ„์ „ ๊ด€๋ฆฌ๊ฐ€ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.
  4. Real-Time Feedback & Tuning

    • Instantly check recoil patterns via API calls during game balance adjustments.
    • ๊ฒŒ์ž„ ๋ฐธ๋Ÿฐ์Šค ์กฐ์ • ์‹œ API ํ˜ธ์ถœ๋กœ ์ฆ‰์‹œ ๋ฐ˜๋™ ํŒจํ„ด์„ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
    • Data-driven decision making improves play-test efficiency.
    • ๋ฐ์ดํ„ฐ ๊ธฐ๋ฐ˜ ์˜์‚ฌ๊ฒฐ์ •์œผ๋กœ ํ”Œ๋ ˆ์ด ํ…Œ์ŠคํŠธ ํšจ์œจ์„ฑ์ด ํ–ฅ์ƒ๋ฉ๋‹ˆ๋‹ค.

Debugging

  • Since this server communicates over HTTP, use verbose logging and the built-in reload flag. For deeper inspection, attach a debugger to the Uvicorn process or review the console error outputs.
  • ์ด ์„œ๋ฒ„๋Š” HTTP๋กœ ํ†ต์‹ ํ•˜๋ฏ€๋กœ, ์ž์„ธํ•œ ๋กœ๊น…๊ณผ --reload ํ”Œ๋ž˜๊ทธ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”. ๋ณด๋‹ค ์‹ฌ์ธต์ ์ธ ๊ฒ€์‚ฌ๋ฅผ ์œ„ํ•ด Uvicorn ํ”„๋กœ์„ธ์Šค์— ๋””๋ฒ„๊ฑฐ๋ฅผ ์—ฐ๊ฒฐํ•˜๊ฑฐ๋‚˜ ์ฝ˜์†” ์˜ค๋ฅ˜ ์ถœ๋ ฅ์„ ํ™•์ธํ•˜๋ฉด ๋ฉ๋‹ˆ๋‹ค.