MCP 服务器

productivity-toolkit-mcp-server

Comprehensive MCP server offering password generation, QR code creation, Base64 encoding/decoding, UUID generation, and color palette tools with secure API key authentication.

README

Productivity Toolkit MCP Server

A comprehensive Model Context Protocol (MCP) server that provides essential productivity tools for developers and power users. This server offers secure, API-key authenticated access to password generation, QR code creation, Base64 encoding/decoding, UUID generation, and color palette tools.

Features

🔐 Password Generator - Create secure passwords with customizable options 📱 QR Code Tools - Generate QR codes and formatted data strings 🔄 Base64 Converter - Encode and decode text using Base64 🆔 UUID Generator - Generate unique identifiers (UUID v4) 🎨 Color Palette Generator - Create beautiful color schemes for design projects

Quick Start

Prerequisites

Node.js 16+
npm or yarn
OpenSSL (for API key generation)

Installation

Clone the repository

git clone https://github.com/ForgeSynapse/mcp-toolkit-v1.git
cd mcp-toolkit-v1

Install dependencies
```
npm install
```
Generate API Key
```
openssl rand -hex 32
```

Set environment variable

export MCP_API_KEY="your_generated_api_key_here"

Run the server
```
npx ts-node server.ts
```

Tools Reference

🔐 Password Generator

Generate secure passwords with customizable complexity.

Tool: generate-password

Parameters:

apiKey (string, required) - Authentication key
length (number, optional) - Password length (8-128, default: 16)
includeNumbers (boolean, optional) - Include numbers (default: true)
includeSymbols (boolean, optional) - Include symbols (default: true)
includeUppercase (boolean, optional) - Include uppercase letters (default: true)
includeLowercase (boolean, optional) - Include lowercase letters (default: true)

Example:

{
  "apiKey": "your_api_key",
  "length": 20,
  "includeSymbols": true,
  "includeNumbers": true
}

📱 QR Code Data Generator

Create formatted data strings for various QR code types.

Tool: generate-qr-data

Parameters:

apiKey (string, required) - Authentication key
type (enum, required) - QR code type: wifi, contact, url, text
data (object, required) - Type-specific data fields

WiFi QR Data:

{
  "apiKey": "your_api_key",
  "type": "wifi",
  "data": {
    "ssid": "MyNetwork",
    "password": "mypassword",
    "security": "WPA"
  }
}

Contact QR Data:

{
  "apiKey": "your_api_key",
  "type": "contact",
  "data": {
    "name": "John Doe",
    "phone": "+1234567890",
    "email": "john@example.com"
  }
}

📱 QR Code Generator

Generate actual QR codes in multiple formats.

Tool: generate-qr-code

Parameters:

apiKey (string, required) - Authentication key
text (string, required) - Text to encode
format (enum, optional) - Output format: png, svg, terminal (default: png)
errorCorrectionLevel (enum, optional) - Error correction: L, M, Q, H (default: M)
width (number, optional) - QR code width in pixels (100-1000, default: 200)

Example:

{
  "apiKey": "your_api_key",
  "text": "https://example.com",
  "format": "png",
  "width": 300
}

🔄 Base64 Converter

Encode or decode text using Base64 encoding.

Tool: base64-convert

Parameters:

apiKey (string, required) - Authentication key
operation (enum, required) - Operation type: encode or decode
text (string, required) - Text to process

Example:

{
  "apiKey": "your_api_key",
  "operation": "encode",
  "text": "Hello, World!"
}

🆔 UUID Generator

Generate unique identifiers (UUID v4).

Tool: generate-uuid

Parameters:

apiKey (string, required) - Authentication key
count (number, optional) - Number of UUIDs to generate (1-10, default: 1)

Example:

{
  "apiKey": "your_api_key",
  "count": 5
}

🎨 Color Palette Generator

Create color palettes for design projects.

Tool: generate-color-palette

Parameters:

apiKey (string, required) - Authentication key
baseColor (string, optional) - Base color in hex format (#RRGGBB)
type (enum, optional) - Palette type: monochromatic, complementary, triadic, random (default: random)
count (number, optional) - Number of colors (3-10, default: 5)

Example:

{
  "apiKey": "your_api_key",
  "baseColor": "#3498db",
  "type": "monochromatic",
  "count": 6
}

Development

Project Structure

ice-cream-mcp-server/
├── server.ts           # Main MCP server implementation
├── package.json        # Dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── README.md          # This file
├── DEPLOYMENT.md      # Deployment guide
└── CLAUDE.md          # Development instructions

Local Development

Install dependencies
```
npm install
```

Set up environment

export MCP_API_KEY="$(openssl rand -hex 32)"

Run with auto-reload
```
npx ts-node --watch server.ts
```
TypeScript compilation
```
npx tsc
```

Architecture

MCP Server: Built with @modelcontextprotocol/sdk
Transport: Uses StdioServerTransport for communication
Authentication: API key validation for all tools
TypeScript: Fully typed with Zod schema validation

Deployment

Render (Recommended)

See DEPLOYMENT.md for complete deployment instructions.

Quick Deploy to Render:

Connect GitHub repository to Render
Create new Web Service
Set build command: npm install
Set start command: npx ts-node server.ts
Add environment variable: MCP_API_KEY=your_key

Other Platforms

This MCP server can be deployed to any platform that supports:

Node.js runtime
Long-running processes
Environment variables
stdin/stdout communication

Security

API Key Requirements

All tools require authentication via the apiKey parameter. The server validates this against the MCP_API_KEY environment variable.

Best Practices

Generate strong API keys using openssl rand -hex 32
Never commit API keys to version control
Rotate API keys regularly
Use environment variables for configuration
Monitor server logs for suspicious activity

Usage Examples

Using with Claude Desktop

Add this server to your Claude Desktop configuration:

{
  "mcpServers": {
    "productivity-toolkit": {
      "command": "npx",
      "args": ["ts-node", "/path/to/server.ts"],
      "env": {
        "MCP_API_KEY": "your_api_key_here"
      }
    }
  }
}

Using with MCP Client

import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const client = new Client({
  name: "productivity-client",
  version: "1.0.0"
});

// Call password generator tool
const result = await client.callTool("generate-password", {
  apiKey: "your_api_key",
  length: 16,
  includeSymbols: true
});