Md5 Calculator

🚀 MD5-MCP: MD5 Hash Calculator MCP Provider

A Model Context Protocol (MCP) provider for calculating MD5 hashes from various data types. This provider offers tools to compute MD5 hashes from strings, JSON data, and Base64-encoded binary data.

🚀 Quick Start

Starting the Provider

If installed globally:

md5-mcp

If installed locally:

npx md5-mcp

This will start the MCP provider using stdio transport, allowing it to work with MCP clients (such as the desktop version of Claude).

Configuration with Claude Desktop

Add the following to your Claude desktop configuration:

{
    "mcpServers": {
        "default": {
            "command": "md5-mcp"
        }
    }
}

✨ Features

• Calculate MD5 hashes from plain text strings (with an optional configuration to remove whitespace).
• Compute MD5 hashes from various JSON data types (strings, numbers, booleans, objects, arrays).
• Calculate MD5 hashes from Base64-encoded binary data.
• Control formatting options (such as preserving whitespace or JSON formatting).
• Easily integrate with Claude and other MCP-compatible clients.

📦 Installation

Global Installation via NPM (Recommended)

# Global installation
npm install -g md5-mcp

# Run the provider directly
md5-mcp

Local Installation

# Local installation in the project
npm install md5-mcp

# Add it to the project's package.json scripts
# "scripts": {
#   "start-md5": "md5-mcp"
# }

Manual Installation

# Clone the repository
git clone https://github.com/tanker327/md5-mcp.git
cd md5-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the provider
npm start

💻 Usage Examples

Basic Usage

calculateMD5

• Parameters:

  • input: The string for which the hash needs to be calculated.
  • trimWhitespace (optional): Whether to remove whitespace from the input string, default is false.

• Example:

{
    "command": "calculateMD5",
    "arguments": {
        "input": "Hello, World!",
        "trimWhitespace": false
    }
}

calculateJSONMD5

• Parameters:

  • jsonInput: The JSON string for which the hash needs to be calculated.
  • preserveFormatting (optional): Whether to preserve the JSON formatting, default is true.

• Example:

{
    "command": "calculateJSONMD5",
    "arguments": {
        "jsonInput": '{"name": "Alice", "age": 30}',
        "preserveFormatting": true
    }
}

calculateBase64MD5

• Parameters:

  • base64Input: The Base64-encoded string for which the hash needs to be calculated.
  • decodeTo (optional): Decode the Base64 to the specified character set, default is 'utf8'.

• Example:

{
    "command": "calculateBase64MD5",
    "arguments": {
        "base64Input": "SGVsbG8sIFdvcmrtYWJjZT!",
        "decodeTo": "utf8"
    }
}

📚 Documentation

Running in Development Mode

npm run dev

This starts TypeScript's watch mode and automatically recompiles when files change.

Running Tests

npm test

Publishing to npm

To publish a new version:

# Update the version in package.json
npm version patch # or minor, or major

# Publish to npm
npm publish

The prepublishOnly script will automatically run tests and build the project before publishing.

📄 License

MIT

🔗 Contribution

Contributions are welcome! Feel free to submit a Pull Request.