devtools-mcp-server 1.0.1

package/README.md

@@ -0,0 +1,114 @@
+# DevTools MCP Server
+
+A powerful MCP (Model Context Protocol) server that gives AI coding assistants access to 30+ developer tools — QR codes, screenshots, PDFs, crypto prices, email validation, AI text processing, currency exchange, and much more.
+
+Works with **Claude Code**, **Cursor**, **Windsurf**, **Cline**, and any MCP-compatible AI assistant.
+
+## Quick Start
+
+### With Claude Code
+```bash
+claude mcp add devtools-mcp-server -- npx devtools-mcp-server
+```
+
+### With Cursor / Windsurf
+Add to your MCP config:
+```json
+{
+  "mcpServers": {
+    "devtools": {
+      "command": "npx",
+      "args": ["devtools-mcp-server"],
+      "env": {
+        "DEVTOOLS_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Get Your Free API Key
+
+```bash
+curl -X POST https://api.commandsector.in/api-key \
+  -H "Content-Type: application/json" \
+  -d '{"email": "you@example.com"}'
+```
+
+Free tier: 100 requests/day, 10/minute.
+
+## Available Tools (30)
+
+### QR Codes
+- `generate_qr_code` — Generate QR codes in 6 styles (standard, rounded, dots, elegant, micro, bold), PNG/SVG/base64
+
+### Screenshots
+- `take_screenshot` — Capture any website as PNG with custom viewport
+
+### Email Validation
+- `validate_email` — Full validation: format, DNS/MX, disposable detection, typo suggestions
+- `validate_emails_batch` — Validate multiple emails at once
+
+### PDF Tools
+- `extract_pdf_text` — Extract text from PDF URLs
+- `get_pdf_metadata` — Get PDF metadata (title, author, pages)
+
+### Crypto Prices
+- `get_crypto_price` — Real-time price for any of 10,000+ coins
+- `get_crypto_market` — Top coins by market cap
+- `search_crypto` — Search by name or symbol
+- `get_trending_crypto` — Currently trending coins
+
+### Currency Exchange
+- `convert_currency` — Convert between 31 currencies (ECB rates)
+- `get_exchange_rates` — Current exchange rates
+
+### IP Geolocation
+- `geolocate_ip` — Country, city, timezone, ISP, coordinates
+
+### Text-to-Speech
+- `text_to_speech` — 300+ voices, 70+ languages (Edge TTS)
+- `list_tts_voices` — Browse available voices
+
+### AI Text Processing
+- `summarize_text` — AI-powered summarization
+- `translate_text` — Translation to any language
+- `rewrite_text` — Rewrite in different tones
+
+### Developer Utilities
+- `generate_uuid` — UUID v4 generation
+- `generate_password` — Secure random passwords
+- `hash_text` — MD5, SHA1, SHA256, SHA512
+- `encode_base64` / `decode_base64` — Base64 encoding
+- `format_json` — Pretty-print JSON
+
+### Image Generation
+- `generate_placeholder_image` — Custom dimensions, colors, text
+- `generate_social_card` — Social media / OG images
+- `generate_avatar` — Unique avatars from name/email
+
+### Invoice Generation
+- `generate_invoice` — Professional PDF invoices
+
+### URL Tools
+- `extract_url_metadata` — Title, description, Open Graph data
+- `expand_short_url` — Reveal shortened URL destinations
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `DEVTOOLS_API_KEY` | Yes | Your API key (get free at signup endpoint) |
+| `DEVTOOLS_API_URL` | No | Custom API URL (defaults to public endpoint) |
+
+## Pricing
+
+| Tier | Price | Daily Limit | Rate Limit |
+|------|-------|-------------|------------|
+| Free | $0 | 100 requests | 10/min |
+| Pro | $9.99/mo | 10,000 requests | 120/min |
+| Enterprise | $49.99/mo | 1,000,000 requests | 600/min |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,370 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const BASE_URL = process.env.DEVTOOLS_API_URL || "https://api.commandsector.in";
+const API_KEY = process.env.DEVTOOLS_API_KEY || "";
+async function apiCall(service, path, params, method = "GET", body) {
+    const url = new URL(`/api/${service}/${path}`, BASE_URL);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined && v !== "")
+                url.searchParams.set(k, v);
+        }
+    }
+    const headers = {
+        "X-API-Key": API_KEY,
+    };
+    const options = { method, headers };
+    if (body && method === "POST") {
+        if (body instanceof FormData) {
+            options.body = body;
+        }
+        else {
+            headers["Content-Type"] = "application/json";
+            options.body = JSON.stringify(body);
+        }
+    }
+    const res = await fetch(url.toString(), options);
+    const contentType = res.headers.get("content-type") || "";
+    if (contentType.includes("application/json")) {
+        return await res.json();
+    }
+    else if (contentType.includes("image/") || contentType.includes("application/pdf") || contentType.includes("audio/")) {
+        const buffer = Buffer.from(await res.arrayBuffer());
+        return { binary: true, contentType, base64: buffer.toString("base64"), size: buffer.length };
+    }
+    else {
+        return { text: await res.text() };
+    }
+}
+function fmt(data) {
+    if (typeof data === "string")
+        return data;
+    return JSON.stringify(data, null, 2);
+}
+const server = new mcp_js_1.McpServer({
+    name: "devtools-mcp-server",
+    version: "1.0.0",
+});
+// ============== QR CODE TOOLS ==============
+server.tool("generate_qr_code", "Generate a QR code image from text or URL. Returns PNG image data.", {
+    data: zod_1.z.string().describe("Text or URL to encode in QR code"),
+    size: zod_1.z.number().optional().describe("QR code size in pixels (default 300)"),
+    style: zod_1.z.enum(["standard", "rounded", "dots", "elegant", "micro", "bold"]).optional().describe("QR code style"),
+    format: zod_1.z.enum(["png", "svg", "base64"]).optional().describe("Output format (default png)"),
+}, async ({ data, size, style, format }) => {
+    const params = { data };
+    if (size)
+        params.size = String(size);
+    if (style)
+        params.style = style;
+    if (format)
+        params.format = format;
+    const result = await apiCall("qr", "generate", params);
+    if (result.binary && result.base64) {
+        return { content: [{ type: "image", data: result.base64, mimeType: result.contentType }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== SCREENSHOT TOOLS ==============
+server.tool("take_screenshot", "Take a screenshot of any website URL. Returns PNG image.", {
+    url: zod_1.z.string().url().describe("Website URL to screenshot"),
+    width: zod_1.z.number().optional().describe("Viewport width (default 1280)"),
+    height: zod_1.z.number().optional().describe("Viewport height (default 720)"),
+    full_page: zod_1.z.boolean().optional().describe("Capture full scrollable page"),
+}, async ({ url, width, height, full_page }) => {
+    const params = { url };
+    if (width)
+        params.width = String(width);
+    if (height)
+        params.height = String(height);
+    if (full_page)
+        params.full_page = "true";
+    const result = await apiCall("screenshot", "capture", params);
+    if (result.binary && result.base64) {
+        return { content: [{ type: "image", data: result.base64, mimeType: result.contentType }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== EMAIL VALIDATION ==============
+server.tool("validate_email", "Validate an email address - checks format, DNS/MX records, disposable domain detection, typo suggestions.", {
+    email: zod_1.z.string().describe("Email address to validate"),
+}, async ({ email }) => {
+    const result = await apiCall("email", `validate/${encodeURIComponent(email)}`, {});
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("validate_emails_batch", "Validate multiple email addresses at once.", {
+    emails: zod_1.z.array(zod_1.z.string()).describe("Array of email addresses to validate"),
+}, async ({ emails }) => {
+    const result = await apiCall("email", "validate/batch", {}, "POST", { emails });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== PDF TOOLS ==============
+server.tool("extract_pdf_text", "Extract text content from a PDF file URL.", {
+    url: zod_1.z.string().url().describe("URL of the PDF file to extract text from"),
+}, async ({ url }) => {
+    const result = await apiCall("pdf", "extract-text", { url });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("get_pdf_metadata", "Get metadata (title, author, pages, etc.) from a PDF file.", {
+    url: zod_1.z.string().url().describe("URL of the PDF file"),
+}, async ({ url }) => {
+    const result = await apiCall("pdf", "metadata", { url });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== CRYPTO PRICE TOOLS ==============
+server.tool("get_crypto_price", "Get the current price and market data for a cryptocurrency.", {
+    coin_id: zod_1.z.string().describe("Coin ID (e.g., 'bitcoin', 'ethereum', 'solana')"),
+    currency: zod_1.z.string().optional().describe("Target currency (default 'usd')"),
+}, async ({ coin_id, currency }) => {
+    const params = {};
+    if (currency)
+        params.vs_currency = currency;
+    const result = await apiCall("crypto", `coin/${coin_id}`, params);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("get_crypto_market", "Get top cryptocurrencies by market cap with prices and stats.", {
+    limit: zod_1.z.number().optional().describe("Number of coins to return (default 20, max 100)"),
+    currency: zod_1.z.string().optional().describe("Target currency (default 'usd')"),
+}, async ({ limit, currency }) => {
+    const params = {};
+    if (limit)
+        params.limit = String(limit);
+    if (currency)
+        params.vs_currency = currency;
+    const result = await apiCall("crypto", "market", params);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("search_crypto", "Search for cryptocurrencies by name or symbol.", {
+    query: zod_1.z.string().describe("Search query (coin name or symbol)"),
+}, async ({ query }) => {
+    const result = await apiCall("crypto", "search", { query });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("get_trending_crypto", "Get currently trending cryptocurrencies.", {}, async () => {
+    const result = await apiCall("crypto", "trending");
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== CURRENCY EXCHANGE ==============
+server.tool("convert_currency", "Convert between currencies using real-time exchange rates from the European Central Bank.", {
+    amount: zod_1.z.number().describe("Amount to convert"),
+    from: zod_1.z.string().describe("Source currency code (e.g., 'USD', 'EUR', 'GBP')"),
+    to: zod_1.z.string().describe("Target currency code"),
+}, async ({ amount, from, to }) => {
+    const result = await apiCall("currency", `convert/${amount}/${from}/${to}`);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("get_exchange_rates", "Get current exchange rates for a base currency.", {
+    base: zod_1.z.string().optional().describe("Base currency (default 'USD')"),
+}, async ({ base }) => {
+    const params = {};
+    if (base)
+        params.base = base;
+    const result = await apiCall("currency", "rates", params);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== IP GEOLOCATION ==============
+server.tool("geolocate_ip", "Get geolocation data for an IP address - country, city, timezone, ISP, coordinates.", {
+    ip: zod_1.z.string().describe("IP address to look up"),
+}, async ({ ip }) => {
+    const result = await apiCall("ip-geo", `lookup/${ip}`);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== TEXT-TO-SPEECH ==============
+server.tool("text_to_speech", "Convert text to speech audio using Microsoft Edge TTS. 300+ voices in 70+ languages.", {
+    text: zod_1.z.string().describe("Text to convert to speech"),
+    voice: zod_1.z.string().optional().describe("Voice name (e.g., 'en-US-AriaNeural', 'en-GB-SoniaNeural')"),
+    rate: zod_1.z.string().optional().describe("Speech rate (e.g., '+20%', '-10%')"),
+}, async ({ text, voice, rate }) => {
+    const params = { text };
+    if (voice)
+        params.voice = voice;
+    if (rate)
+        params.rate = rate;
+    const result = await apiCall("tts", "synthesize", params);
+    if (result.binary) {
+        return { content: [{ type: "text", text: `Audio generated: ${result.size} bytes, format: ${result.contentType}. Base64 data available.` }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("list_tts_voices", "List available text-to-speech voices, optionally filtered by language.", {
+    language: zod_1.z.string().optional().describe("Filter by language code (e.g., 'en', 'es', 'fr')"),
+}, async ({ language }) => {
+    const params = {};
+    if (language)
+        params.language = language;
+    const result = await apiCall("tts", "voices", params);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== AI TEXT TOOLS ==============
+server.tool("summarize_text", "Summarize a long text into key points using AI.", {
+    text: zod_1.z.string().describe("Text to summarize"),
+    length: zod_1.z.enum(["short", "medium", "long"]).optional().describe("Summary length"),
+}, async ({ text, length }) => {
+    const body = { text };
+    if (length)
+        body.length = length;
+    const result = await apiCall("ai", "summarize", {}, "POST", body);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("translate_text", "Translate text to another language using AI.", {
+    text: zod_1.z.string().describe("Text to translate"),
+    target_language: zod_1.z.string().describe("Target language (e.g., 'Spanish', 'French', 'Japanese')"),
+}, async ({ text, target_language }) => {
+    const result = await apiCall("ai", "translate", {}, "POST", { text, target_language });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("rewrite_text", "Rewrite text in a different tone or style using AI.", {
+    text: zod_1.z.string().describe("Text to rewrite"),
+    tone: zod_1.z.enum(["professional", "casual", "academic", "creative", "concise"]).optional().describe("Target tone"),
+}, async ({ text, tone }) => {
+    const body = { text };
+    if (tone)
+        body.tone = tone;
+    const result = await apiCall("ai", "rewrite", {}, "POST", body);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== DEVELOPER UTILITIES ==============
+server.tool("generate_uuid", "Generate a UUID v4.", {}, async () => {
+    const result = await apiCall("devtools", "generate/uuid");
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("generate_password", "Generate a secure random password.", {
+    length: zod_1.z.number().optional().describe("Password length (default 20)"),
+    include_special: zod_1.z.boolean().optional().describe("Include special characters"),
+}, async ({ length, include_special }) => {
+    const params = {};
+    if (length)
+        params.length = String(length);
+    if (include_special !== undefined)
+        params.special = String(include_special);
+    const result = await apiCall("devtools", "generate/password", params);
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("hash_text", "Hash text using various algorithms (md5, sha1, sha256, sha512).", {
+    text: zod_1.z.string().describe("Text to hash"),
+    algorithm: zod_1.z.enum(["md5", "sha1", "sha256", "sha512"]).optional().describe("Hash algorithm (default sha256)"),
+}, async ({ text, algorithm }) => {
+    const algo = algorithm || "sha256";
+    const result = await apiCall("devtools", `hash/${algo}`, { text });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("encode_base64", "Encode text to base64.", {
+    text: zod_1.z.string().describe("Text to encode"),
+}, async ({ text }) => {
+    const result = await apiCall("devtools", "encode/base64", { text });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("decode_base64", "Decode base64 text.", {
+    text: zod_1.z.string().describe("Base64 text to decode"),
+}, async ({ text }) => {
+    const result = await apiCall("devtools", "decode/base64", { text });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("format_json", "Format/pretty-print JSON text.", {
+    json: zod_1.z.string().describe("JSON string to format"),
+}, async ({ json }) => {
+    const result = await apiCall("devtools", "json/format", { json });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== IMAGE GENERATION ==============
+server.tool("generate_placeholder_image", "Generate a placeholder image with custom dimensions, colors, and text.", {
+    width: zod_1.z.number().describe("Image width in pixels"),
+    height: zod_1.z.number().describe("Image height in pixels"),
+    bg_color: zod_1.z.string().optional().describe("Background color hex (e.g., 'cccccc')"),
+    text: zod_1.z.string().optional().describe("Text to display on image"),
+    text_color: zod_1.z.string().optional().describe("Text color hex"),
+}, async ({ width, height, bg_color, text, text_color }) => {
+    const params = {};
+    if (bg_color)
+        params.bg = bg_color;
+    if (text)
+        params.text = text;
+    if (text_color)
+        params.color = text_color;
+    const result = await apiCall("image", `placeholder/${width}x${height}`, params);
+    if (result.binary && result.base64) {
+        return { content: [{ type: "image", data: result.base64, mimeType: result.contentType }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("generate_social_card", "Generate a social media card / Open Graph image with title and description.", {
+    title: zod_1.z.string().describe("Card title"),
+    description: zod_1.z.string().optional().describe("Card description"),
+    theme: zod_1.z.string().optional().describe("Color theme"),
+}, async ({ title, description, theme }) => {
+    const params = { title };
+    if (description)
+        params.description = description;
+    if (theme)
+        params.theme = theme;
+    const result = await apiCall("image", "social-card", params);
+    if (result.binary && result.base64) {
+        return { content: [{ type: "image", data: result.base64, mimeType: result.contentType }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("generate_avatar", "Generate a unique avatar/identicon from a name or email.", {
+    name: zod_1.z.string().describe("Name or email to generate avatar from"),
+    size: zod_1.z.number().optional().describe("Image size in pixels"),
+}, async ({ name, size }) => {
+    const params = { name };
+    if (size)
+        params.size = String(size);
+    const result = await apiCall("image", "avatar", params);
+    if (result.binary && result.base64) {
+        return { content: [{ type: "image", data: result.base64, mimeType: result.contentType }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== INVOICE GENERATION ==============
+server.tool("generate_invoice", "Generate a professional PDF invoice.", {
+    from_name: zod_1.z.string().describe("Sender/company name"),
+    to_name: zod_1.z.string().describe("Recipient/client name"),
+    items: zod_1.z.array(zod_1.z.object({
+        description: zod_1.z.string(),
+        quantity: zod_1.z.number(),
+        unit_price: zod_1.z.number(),
+    })).describe("Invoice line items"),
+    invoice_number: zod_1.z.string().optional().describe("Invoice number"),
+    currency: zod_1.z.string().optional().describe("Currency code (default USD)"),
+    notes: zod_1.z.string().optional().describe("Additional notes"),
+}, async ({ from_name, to_name, items, invoice_number, currency, notes }) => {
+    const body = { from_name, to_name, items };
+    if (invoice_number)
+        body.invoice_number = invoice_number;
+    if (currency)
+        body.currency = currency;
+    if (notes)
+        body.notes = notes;
+    const result = await apiCall("invoice", "generate", {}, "POST", body);
+    if (result.binary) {
+        return { content: [{ type: "text", text: `Invoice PDF generated: ${result.size} bytes. Content type: ${result.contentType}` }] };
+    }
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== URL TOOLS ==============
+server.tool("extract_url_metadata", "Extract metadata (title, description, Open Graph, favicon) from a URL.", {
+    url: zod_1.z.string().url().describe("URL to extract metadata from"),
+}, async ({ url }) => {
+    const result = await apiCall("url", "metadata", { url });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+server.tool("expand_short_url", "Expand a shortened URL to reveal its final destination.", {
+    url: zod_1.z.string().url().describe("Short URL to expand"),
+}, async ({ url }) => {
+    const result = await apiCall("url", "expand", { url });
+    return { content: [{ type: "text", text: fmt(result) }] };
+});
+// ============== STARTUP ==============
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "devtools-mcp-server",
+  "version": "1.0.1",
+  "description": "MCP server providing 70+ developer tools - QR codes, PDFs, screenshots, crypto prices, email validation, AI text processing, and more. Use with Claude Code, Cursor, Windsurf, and other AI coding assistants.",
+  "main": "dist/index.js",
+  "bin": {
+    "devtools-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "developer-tools",
+    "ai-tools",
+    "claude",
+    "cursor",
+    "qr-code",
+    "pdf",
+    "screenshot",
+    "crypto",
+    "email-validation",
+    "text-to-speech",
+    "currency-exchange",
+    "ip-geolocation"
+  ],
+  "author": "Ketan",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}