mcp-server
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
-
Productivity Boost
- No need to implement complex recoil algorithms yourself.
- ๋ณต์กํ ๋ฐ๋ ์๊ณ ๋ฆฌ์ฆ์ ์ง์ ๊ตฌํํ ํ์๊ฐ ์์ต๋๋ค.
- Accelerates data validation and prototyping with built-in visualization tools.
- ๋ด์ฅ๋ ์๊ฐํ ๋๊ตฌ๋ก ๋ฐ์ดํฐ ๊ฒ์ฆ ๋ฐ ํ๋กํ ํ์ ์๋๊ฐ ํฅ์๋ฉ๋๋ค.
-
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 ์์ง๋์ด, ๊ฒ์ ๊ฐ๋ฐ์ ๊ฐ ์ํํ๊ฒ ์ฐ๋๋ฉ๋๋ค.
- Unified
-
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 ํ์ดํ๋ผ์ธ๊ณผ ์ฐ๋ํ์ฌ ์๋ ๋ฐฐํฌ ๋ฐ ๋ฒ์ ๊ด๋ฆฌ๊ฐ ๊ฐ๋ฅํฉ๋๋ค.
-
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 ํ๋ก์ธ์ค์ ๋๋ฒ๊ฑฐ๋ฅผ ์ฐ๊ฒฐํ๊ฑฐ๋ ์ฝ์ ์ค๋ฅ ์ถ๋ ฅ์ ํ์ธํ๋ฉด ๋ฉ๋๋ค.