mcp-texttools 1.0.4 → 1.1.0

package/README.md

@@ -1,84 +1,8 @@
-# mcp-texttools
 
-MCP server with 10 text transformation tools for AI assistants (Claude, Cursor, etc).
-
-## Install
-
-```bash
-npx mcp-texttools
-```
-
-### Claude Desktop
-
-Add to `claude_desktop_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "texttools": {
-      "command": "npx",
-      "args": ["-y", "mcp-texttools"]
-    }
-  }
-}
-```
-
-### Cursor
-
-Add to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "texttools": {
-      "command": "npx",
-      "args": ["-y", "mcp-texttools"]
-    }
-  }
-}
-```
-
-## Tools
-
-| Tool | Description |
-|------|-------------|
-| `case_convert` | Convert between camelCase, snake_case, kebab-case, PascalCase, CONSTANT_CASE, Title Case, dot.case |
-| `slugify` | Convert text to URL-friendly slug |
-| `word_count` | Count words, characters, sentences, paragraphs + reading time |
-| `lorem_ipsum` | Generate placeholder text (words, sentences, or paragraphs) |
-| `truncate` | Smart truncation at word/sentence/character boundaries |
-| `regex_replace` | Find & replace with regex (supports capture groups) |
-| `markdown_strip` | Strip markdown formatting to plain text |
-| `text_reverse` | Reverse by characters, words, or lines |
-| `line_sort` | Sort lines (alpha, numeric, length, random) + dedup |
-| `text_diff` | Compare two texts line by line |
-
-## Examples
-
-**Convert case:**
-- Input: `"myVariableName"` → snake → `my_variable_name`
-- Input: `"my-api-endpoint"` → pascal → `MyApiEndpoint`
-
-**Slugify:**
-- Input: `"Hello World! This is a Test"` → `hello-world-this-is-a-test`
-
-**Word count:**
-- Returns words, characters, sentences, paragraphs, reading time
-
-## Part of the MCP Dev Tools Suite
-
-- [mcp-devutils](https://www.npmjs.com/package/mcp-devutils) — UUID, hash, base64, timestamps, JWT decode, and more
-- [mcp-apitools](https://www.npmjs.com/package/mcp-apitools) — HTTP status, MIME types, JWT create, mock data, CORS headers
-- **mcp-texttools** — Text transformation and analysis (this package)
-- [mcp-mathtools](https://www.npmjs.com/package/mcp-mathtools) — 12 math & statistics tools: arithmetic, statistics, unit conversion, financial calculations
-- [mcp-datetime](https://www.npmjs.com/package/mcp-datetime) — 10 date & time tools: timezone conversion, date math, cron explanation, business days
-- [mcp-quick-calc](https://www.npmjs.com/package/mcp-quick-calc) — 5 calculator tools: currency conversion, percentages, compound interest, unit conversion, loan payments
-- **[mcp-all-tools](https://www.npmjs.com/package/mcp-all-tools)** — All 54+ tools in a single MCP server
 
 ## Support
 
-If you find this useful, consider [buying me a coffee](https://buymeacoffee.com/gl89tu25lp)!
-
-## License
+If this tool saves you time, consider supporting development:
 
-MIT
+- [Buy me a coffee](https://buymeacoffee.com/gl89tu25lp)
+- [Tip via Stripe ($3)](https://buy.stripe.com/dRm8wP8R295Z9VyeN59Zm00)

package/index.js

@@ -4,7 +4,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 
 const server = new Server(
-  { name: "mcp-texttools", version: "1.0.0" },
+  { name: "mcp-texttools", version: "1.1.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -152,6 +152,69 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           required: ["text1", "text2"]
         }
+      },
+      {
+        name: "extract_emails",
+        description: "Extract all email addresses from text, with optional deduplication",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to extract emails from" },
+            unique: { type: "boolean", description: "Return only unique emails (default: true)" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "extract_urls",
+        description: "Extract all URLs (http/https) from text, with optional deduplication",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to extract URLs from" },
+            unique: { type: "boolean", description: "Return only unique URLs (default: true)" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "text_pad",
+        description: "Pad text to a fixed width — left, right, or center aligned",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to pad" },
+            width: { type: "number", description: "Target width in characters" },
+            align: { type: "string", enum: ["left", "right", "center"], description: "Alignment (default: right)" },
+            char: { type: "string", description: "Padding character (default: space)" }
+          },
+          required: ["text", "width"]
+        }
+      },
+      {
+        name: "text_wrap",
+        description: "Wrap text to a specified line width, breaking at word boundaries",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to wrap" },
+            width: { type: "number", description: "Maximum line width (default: 80)" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "string_repeat",
+        description: "Repeat a string N times with an optional separator",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to repeat" },
+            count: { type: "number", description: "Number of repetitions (1-1000, default: 2)" },
+            separator: { type: "string", description: "Separator between repetitions (default: empty)" }
+          },
+          required: ["text"]
+        }
       }
     ]
   };
@@ -447,6 +510,82 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return { content: [{ type: "text", text: output.join("\n") + summary }] };
       }
 
+      case "extract_emails": {
+        const { text, unique = true } = args;
+        const emailRegex = /[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}/g;
+        let emails = text.match(emailRegex) || [];
+        if (unique) emails = [...new Set(emails.map(e => e.toLowerCase()))];
+        if (emails.length === 0) {
+          return { content: [{ type: "text", text: "No email addresses found." }] };
+        }
+        return { content: [{ type: "text", text: `Found ${emails.length} email(s):\n\n${emails.join("\n")}` }] };
+      }
+
+      case "extract_urls": {
+        const { text, unique = true } = args;
+        const urlRegex = /https?:\/\/[^\s<>\"')\]]+/g;
+        let urls = text.match(urlRegex) || [];
+        if (unique) urls = [...new Set(urls)];
+        if (urls.length === 0) {
+          return { content: [{ type: "text", text: "No URLs found." }] };
+        }
+        return { content: [{ type: "text", text: `Found ${urls.length} URL(s):\n\n${urls.join("\n")}` }] };
+      }
+
+      case "text_pad": {
+        const { text, width, align = "right", char = " " } = args;
+        const padChar = char.charAt(0) || " ";
+        const lines = text.split("\n");
+        const padded = lines.map(line => {
+          if (line.length >= width) return line;
+          const diff = width - line.length;
+          switch (align) {
+            case "left":
+              return line + padChar.repeat(diff);
+            case "center": {
+              const left = Math.floor(diff / 2);
+              const right = diff - left;
+              return padChar.repeat(left) + line + padChar.repeat(right);
+            }
+            case "right":
+            default:
+              return padChar.repeat(diff) + line;
+          }
+        });
+        return { content: [{ type: "text", text: padded.join("\n") }] };
+      }
+
+      case "text_wrap": {
+        const { text, width = 80 } = args;
+        const paragraphs = text.split("\n");
+        const wrapped = paragraphs.map(para => {
+          if (para.trim() === "") return "";
+          const words = para.split(/\s+/);
+          const lines = [];
+          let current = "";
+          for (const word of words) {
+            if (current.length === 0) {
+              current = word;
+            } else if (current.length + 1 + word.length <= width) {
+              current += " " + word;
+            } else {
+              lines.push(current);
+              current = word;
+            }
+          }
+          if (current) lines.push(current);
+          return lines.join("\n");
+        });
+        return { content: [{ type: "text", text: wrapped.join("\n") }] };
+      }
+
+      case "string_repeat": {
+        const { text, count = 2, separator = "" } = args;
+        const n = Math.max(1, Math.min(1000, count));
+        const result = Array(n).fill(text).join(separator);
+        return { content: [{ type: "text", text: result }] };
+      }
+
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-texttools",
-  "version": "1.0.4",
-  "description": "MCP server with 10 text transformation tools — case conversion, slug, word count, lorem ipsum, truncate, regex replace, markdown strip, character count, reverse, line sort",
+  "version": "1.1.0",
+  "description": "MCP server with 15 text transformation tools \u2014 case conversion, slug, word count, lorem ipsum, truncate, regex replace, markdown strip, reverse, line sort, text diff, extract emails, extract URLs, text pad, text wrap, string repeat",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -24,7 +24,12 @@
     "claude",
     "cursor",
     "ai-tools",
-    "string-utils"
+    "string-utils",
+    "extract-email",
+    "extract-url",
+    "text-wrap",
+    "string-repeat",
+    "text-padding"
   ],
   "author": "Hong Teoh",
   "license": "MIT",
@@ -34,5 +39,13 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hlteoh37/mcp-texttools.git"
+  },
+  "homepage": "https://github.com/hlteoh37/mcp-texttools#readme",
+  "bugs": {
+    "url": "https://github.com/hlteoh37/mcp-texttools/issues"
   }
 }