string-utils-ai-mcp 1.0.0__py3-none-any.whl

server.py

@@ -0,0 +1,164 @@
+"""
+String Utils AI MCP Server
+String manipulation and transformation tools powered by MEOK AI Labs.
+"""
+
+
+import sys, os
+sys.path.insert(0, os.path.expanduser('~/clawd/meok-labs-engine/shared'))
+from auth_middleware import check_access
+
+import re
+import time
+import unicodedata
+from collections import defaultdict
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP("string-utils-ai", instructions="MEOK AI Labs MCP Server")
+
+_call_counts: dict[str, list[float]] = defaultdict(list)
+FREE_TIER_LIMIT = 50
+WINDOW = 86400
+
+
+def _check_rate_limit(tool_name: str) -> None:
+    now = time.time()
+    _call_counts[tool_name] = [t for t in _call_counts[tool_name] if now - t < WINDOW]
+    if len(_call_counts[tool_name]) >= FREE_TIER_LIMIT:
+        raise ValueError(f"Rate limit exceeded for {tool_name}. Free tier: {FREE_TIER_LIMIT}/day. Upgrade at https://meok.ai/pricing")
+    _call_counts[tool_name].append(now)
+
+
+@mcp.tool()
+def slugify(text: str, separator: str = "-", max_length: int = 80, lowercase: bool = True, api_key: str = "") -> dict:
+    """Convert text to a URL-friendly slug.
+
+    Args:
+        text: Text to slugify
+        separator: Word separator (default '-')
+        max_length: Maximum slug length (default 80)
+        lowercase: Convert to lowercase (default True)
+    """
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://buy.stripe.com/14A4gB3K4eUWgYR56o8k836"}
+
+    _check_rate_limit("slugify")
+    slug = unicodedata.normalize('NFKD', text).encode('ascii', 'ignore').decode('ascii')
+    if lowercase:
+        slug = slug.lower()
+    slug = re.sub(r'[^\w\s-]', '', slug)
+    slug = re.sub(r'[-\s]+', separator, slug).strip(separator)
+    if max_length and len(slug) > max_length:
+        slug = slug[:max_length].rstrip(separator)
+    return {"slug": slug, "original": text, "length": len(slug)}
+
+
+@mcp.tool()
+def camel_to_snake(text: str, direction: str = "camel_to_snake", api_key: str = "") -> dict:
+    """Convert between camelCase, snake_case, kebab-case, and PascalCase.
+
+    Args:
+        text: String to convert
+        direction: Conversion type - 'camel_to_snake', 'snake_to_camel', 'to_kebab', 'to_pascal', 'to_constant'
+    """
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://buy.stripe.com/14A4gB3K4eUWgYR56o8k836"}
+
+    _check_rate_limit("camel_to_snake")
+    # First normalize to words
+    words = []
+    if '_' in text:
+        words = [w for w in text.split('_') if w]
+    elif '-' in text:
+        words = [w for w in text.split('-') if w]
+    else:
+        parts = re.sub(r'([A-Z])', r' \1', text).strip().split()
+        words = [w.lower() for w in parts if w]
+    if not words:
+        words = [text.lower()]
+    results = {}
+    results["snake_case"] = '_'.join(w.lower() for w in words)
+    results["camelCase"] = words[0].lower() + ''.join(w.capitalize() for w in words[1:])
+    results["PascalCase"] = ''.join(w.capitalize() for w in words)
+    results["kebab-case"] = '-'.join(w.lower() for w in words)
+    results["CONSTANT_CASE"] = '_'.join(w.upper() for w in words)
+    target_map = {"camel_to_snake": "snake_case", "snake_to_camel": "camelCase",
+                  "to_kebab": "kebab-case", "to_pascal": "PascalCase", "to_constant": "CONSTANT_CASE"}
+    target = target_map.get(direction, "snake_case")
+    return {"result": results[target], "direction": direction, "all_formats": results, "words": words}
+
+
+@mcp.tool()
+def truncate_smart(text: str, max_length: int = 100, suffix: str = "...", preserve_words: bool = True, api_key: str = "") -> dict:
+    """Smartly truncate text at word boundaries with a suffix.
+
+    Args:
+        text: Text to truncate
+        max_length: Maximum length including suffix (default 100)
+        suffix: Suffix to append when truncated (default '...')
+        preserve_words: Don't break mid-word (default True)
+    """
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://buy.stripe.com/14A4gB3K4eUWgYR56o8k836"}
+
+    _check_rate_limit("truncate_smart")
+    if len(text) <= max_length:
+        return {"text": text, "truncated": False, "original_length": len(text)}
+    target_len = max_length - len(suffix)
+    if target_len <= 0:
+        return {"text": suffix[:max_length], "truncated": True, "original_length": len(text)}
+    truncated = text[:target_len]
+    if preserve_words and ' ' in truncated:
+        last_space = truncated.rfind(' ')
+        if last_space > target_len * 0.5:
+            truncated = truncated[:last_space]
+    truncated = truncated.rstrip(' .,;:!?-')
+    result = truncated + suffix
+    return {"text": result, "truncated": True, "original_length": len(text),
+            "result_length": len(result), "chars_removed": len(text) - len(truncated)}
+
+
+@mcp.tool()
+def extract_numbers(text: str, include_decimals: bool = True, include_negative: bool = True, api_key: str = "") -> dict:
+    """Extract all numbers from text.
+
+    Args:
+        text: Text to extract numbers from
+        include_decimals: Include decimal numbers (default True)
+        include_negative: Include negative numbers (default True)
+    """
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://buy.stripe.com/14A4gB3K4eUWgYR56o8k836"}
+
+    _check_rate_limit("extract_numbers")
+    if include_negative and include_decimals:
+        pattern = r'-?\d+\.?\d*'
+    elif include_decimals:
+        pattern = r'\d+\.?\d*'
+    elif include_negative:
+        pattern = r'-?\d+'
+    else:
+        pattern = r'\d+'
+    matches = re.findall(pattern, text)
+    numbers = []
+    for m in matches:
+        try:
+            if '.' in m:
+                numbers.append(float(m))
+            else:
+                numbers.append(int(m))
+        except ValueError:
+            pass
+    stats = {}
+    if numbers:
+        stats = {"min": min(numbers), "max": max(numbers),
+                 "sum": sum(numbers), "average": sum(numbers) / len(numbers)}
+    return {"numbers": numbers, "count": len(numbers), "statistics": stats}
+
+
+if __name__ == "__main__":
+    mcp.run()

string_utils_ai_mcp-1.0.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: string-utils-ai-mcp
+Version: 1.0.0
+Summary: String Utils Ai tools for AI agents. Capabilities: slugify, camel to snake, truncate smart. Built by MEOK AI Labs.
+Project-URL: Homepage, https://meok.ai
+Project-URL: Repository, https://github.com/CSOAI-ORG/string-utils-ai-mcp
+Author-email: MEOK AI Labs <nicholas@meok.ai>
+License: MIT License
+        
+        Copyright (c) 2026 MEOK AI Labs
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+License-File: LICENSE
+Keywords: ai,mcp,meok,string,utils
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0

string_utils_ai_mcp-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+server.py,sha256=xMB0PFqmBs-zx3M0GvSZLLENTSBR09rGySjVcW3ueEM,6217
+string_utils_ai_mcp-1.0.0.dist-info/METADATA,sha256=r4YXRH1qXDkpOFBzyGqLu_R58N-OWHHy2qnNCXY5T3k,1366
+string_utils_ai_mcp-1.0.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+string_utils_ai_mcp-1.0.0.dist-info/entry_points.txt,sha256=NA1I-RMxbZ4h2q8u95csY9YH4VNPUxTwl2rkKYn9U-E,52
+string_utils_ai_mcp-1.0.0.dist-info/licenses/LICENSE,sha256=ibFbFVuWMg3hkFJtLijRTUi6DDoUbdR4oE78M6MKq-I,607
+string_utils_ai_mcp-1.0.0.dist-info/RECORD,,

string_utils_ai_mcp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

string_utils_ai_mcp-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+string_utils_ai_mcp = server:main

string_utils_ai_mcp-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,13 @@
+MIT License
+
+Copyright (c) 2026 MEOK AI Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.