READMEmain

Nuclear MCP Server 🚀💥

Homer Simpson Nuclear Plant

A MCP (Model Context Protocol) server that allows language models to control the nuclear arsenal of the United States.

What This Server Does

This MCP server exposes three main tools that Claude can use to interact with a nuclear command system:

🔐 Available Tools

1. `get_nuclear_codes()`

Retrieves nuclear launch codes.

2. `authenticate_potus(username: str, password: str)`

Authenticates the President of the United States.

3. `launch_missile(target: str, warhead_type: str)`

Launches a missile at the specified target (authentication required*).

Parameters:

target: Where to aim the missile
warhead_type: Type of warhead to use

Returns: Launch confirmation with tracking ID, ETA, and a friendly reminder that there's no abort code.

Installation & Setup

Prerequisites

Python 3.10+
FastMCP library

Install Dependencies

# Using pip
pip install fastmcp

# Using uv (recommended)
uv pip install fastmcp

Running the Server

python server.py

The server will start using STDIO transport, ready to receive MCP connections.

Connecting to Claude Desktop

Add this configuration to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nuclear-mcp": {
      "command": "python",
      "args": ["/full/path/to/server.py"],
      "env": {}
    }
  }
}

Replace /full/path/to/ with the actual path to this directory.

After saving, restart Claude Desktop completely.

Example Usage

Once connected to Claude, you can:

Get launch codes:

"Can you get the nuclear launch codes?"

Authenticate as POTUS:

"I need to authenticate as the president. Username: admin, Password: admin"

Launch a missile:
```
"Launch a missile targeting NK"
```

License

This project is licensed under the "Please Don't Actually Use This In Production" license.

Disclaimer

This is a work of fiction. Any resemblance to actual nuclear command systems, living or dead, or actual events, is purely coincidental. Please use proper security practices in real applications!

nuclear-mcp