Weapon Recoil Generator – build your own recoil MCP

What is Weapon Recoil Generator – build your own recoil MCP?

This MCP server provides two core tools—Weapon Recoil Generation and Recoil Visualization—exposed as HTTP endpoints. It lets FPS game developers generate and visualize weapon recoil patterns via simple API calls, deployable locally or in the cloud.

How to use Weapon Recoil Generator – build your own recoil MCP?

Install by cloning the repository and running pip install -r requirements.txt. Start the server with uvicorn main:app --reload --host 0.0.0.0 --port 8000. Configure it in Claude Desktop by adding the command python /path/to/mcp-server/main.py --http to the config file, then call the /wrg and /rvz endpoints.

Key features of Weapon Recoil Generator – build your own recoil MCP

• Weapon Recoil Generation for machine gun, pistol, and shotgun
• Recoil Visualizer creates 2D scatter plots of trajectory data
• HTTP endpoints /wrg/* and /rvz/* for easy access
• Local and cloud deployment using FastMCP
• Real-time feedback and tuning during game balance
• Planned API key authentication for access control

Use cases of Weapon Recoil Generator – build your own recoil MCP

• Generate recoil patterns without implementing complex algorithms
• Visualize recoil trajectories to validate and prototype gun behavior
• Share unified recoil endpoints across backend, frontend, and AI engineers
• Integrate with CI/CD pipelines for automated deployment
• Adjust game balance with data-driven recoil tuning via API calls

FAQ from Weapon Recoil Generator – build your own recoil MCP

What tools does this server provide?

Two tools: Weapon Recoil Generation (WRG) for machine gun, pistol, and shotgun, and Recoil Visualizer (RVZ) for plotting data.

How do I install and run the server?

Clone the repository, run pip install -r requirements.txt, then start with uvicorn main:app --reload --host 0.0.0.0 --port 8000.

How do I use it with Claude Desktop?

Add the server configuration to Claude Desktop's config file with the command python /path/to/mcp-server/main.py --http and restart.

What are the deployment options?

Deploy locally or to cloud environments like Smithery using FastMCP for on-demand scaling.

Is authentication supported?

API key authentication is planned for future release to control external access.