MCP Password Generator

You have a lightweight, powerful MCP server that generates secure passwords and memorable passphrases. It exposes an HTTP endpoint for easy integration and a local STDIO entry for direct development workflows, making it simple to connect from Claude Desktop, Raycast, or any MCP client.

How to use

You connect to the server with your MCP client to generate passwords or memorable passphrases. Use the two main tools provided by the server: one focuses on random password generation and the other on creating passphrases from words. You can customize length, character sets, and separators, and you can enable optional emojis for additional entropy and fun.

Practical usage patterns you can perform include generating long, complex passwords with uppercases, digits, symbols, and optional emojis, or producing a readable passphrase composed of several words separated by a chosen delimiter. You can also request a specific number of words and apply capitalization or digits to words to make the passphrase easier to remember while staying secure.

How to install

# Prerequisites
Python 3.10+
pip

# 1. Install dependencies
pip install -r requirements.txt

# 2. Start the HTTP MCP server
python server.py
# Server will be available at http://0.0.0.0:8000

# If you prefer running via Docker Compose on a VM
scp -r server.py requirements.txt eff_large_wordlist.txt Dockerfile compose.yaml david@<VM_IP>:/home/david/mcp-servers/passwords/
ssh david@<VM_IP>
cd /home/david/mcp-servers/passwords
docker compose up -d --build
# Access at http://<VM_IP>:8004/mcp

Configuration and usage notes

The server exposes two MCP tools you can call from your client. The HTTP endpoint is the primary method for integration, and the local STDIO entry is useful for development and testing.

• Random password generation tool allows you to define length and character sets (uppercase, digits, symbols, and optionally emojis).
• Memorable password tool lets you define the number of words, separators, and optional capitalization or digits per word.

Tools supported by the server

• generate_random_password: Create a random password with configurable length and character sets, with optional emojis for added entropy.

• generate_memorable_password: Create a passphrase from a sequence of words with a chosen separator and optional capitalization or digits.

Troubleshooting

If you encounter HTTP 400 or 406 errors, ensure your client sends the required headers for the Streamable HTTP protocol: Content-Type: application/json and Accept: application/json, text/event-stream. Use a curl example as a reference to craft your requests correctly.

Security and best practices

Keep the server up to date with the latest Python dependencies. When exposing the HTTP endpoint, restrict access to trusted clients or networks as appropriate for your environment. If you enable emojis or extended character sets, be mindful of compatibility with downstream clients.

Available tools

generate_random_password

Generates a secure password with configurable length and character sets (uppercase, digits, symbols, and optional emojis).

generate_memorable_password

Generates a passphrase from a specified number of words with a chosen separator and optional enhancements like capitalization and per-word digits.