diff-ai-mcp 1.0.0__tar.gz

diff_ai_mcp-1.0.0/.github/workflows/mcp-smithery-publish.yml

@@ -0,0 +1,40 @@
+name: Publish to Smithery
+
+on:
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  publish:
+    name: Publish MCP Server to Smithery
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      attestations: write
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
+        with:
+          persist-credentials: false
+
+      - name: Setup Node.js
+        uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
+        with:
+          node-version: '22'
+
+      - name: Publish to Smithery
+        id: smithery_publish
+        env:
+          SMITHERY_API_KEY: ${{ secrets.SMITHERY_API_KEY }}
+        run: |
+          npx @smithery/cli mcp publish "https://github.com/${{ github.repository }}" -n nicholastempleman/${{ github.event.repository.name }} --json
+
+      - name: Attest build provenance
+        uses: actions/attest-build-provenance@v2
+        with:
+          subject-name: ${{ github.repository }}
+          subject-digest: sha256:${{ github.sha }}
+          push-to-registry: false

diff_ai_mcp-1.0.0/.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.dist/
+build/
+

diff_ai_mcp-1.0.0/.mcp.json

@@ -0,0 +1,83 @@
+{
+  "name": "diff-ai-mcp",
+  "description": "AI-powered diff ai MCP server for agents. Supports diff texts, diff summary, word diff. By MEOK AI Labs.",
+  "version": "1.0.0",
+  "tools": [
+    {
+      "name": "diff_texts",
+      "description": "MEOK AI Labs tool.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "text_a": {
+            "type": "string"
+          },
+          "text_b": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "text_a",
+          "text_b"
+        ]
+      }
+    },
+    {
+      "name": "diff_summary",
+      "description": "MEOK AI Labs tool.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "text_a": {
+            "type": "string"
+          },
+          "text_b": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "text_a",
+          "text_b"
+        ]
+      }
+    },
+    {
+      "name": "word_diff",
+      "description": "MEOK AI Labs tool.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "text_a": {
+            "type": "string"
+          },
+          "text_b": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "text_a",
+          "text_b"
+        ]
+      }
+    },
+    {
+      "name": "similarity_score",
+      "description": "MEOK AI Labs tool.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "text_a": {
+            "type": "string"
+          },
+          "text_b": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "text_a",
+          "text_b"
+        ]
+      }
+    }
+  ]
+}

diff_ai_mcp-1.0.0/Dockerfile.glama

@@ -0,0 +1,20 @@
+FROM python:3.14-slim
+
+ENV PYTHONUNBUFFERED=1
+ENV PYTHONDONTWRITEBYTECODE=1
+
+RUN apt-get update && apt-get install -y --no-install-recommends git build-essential && rm -rf /var/lib/apt/lists/*
+RUN pip install --no-cache-dir uv
+
+RUN useradd -m -s /bin/bash nicholas &&     mkdir -p /home/nicholas/clawd/meok-labs-engine/shared &&     chown -R nicholas:nicholas /home/nicholas
+
+WORKDIR /app
+USER nicholas
+
+RUN uv venv /home/nicholas/.venv
+ENV PATH="/home/nicholas/.venv/bin:$PATH"
+
+COPY --chown=nicholas:nicholas . /app
+RUN uv pip install -e .
+
+CMD ["python", "mcp-wrapper.py"]

diff_ai_mcp-1.0.0/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.

diff_ai_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: diff-ai-mcp
+Version: 1.0.0
+Summary: AI-powered diff ai MCP server for agents. Supports diff texts, diff summary, word diff. By MEOK AI Labs.
+Project-URL: Homepage, https://meok.ai
+Project-URL: Repository, https://github.com/CSOAI-ORG/diff-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,diff,mcp,meok
+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

diff_ai_mcp-1.0.0/README.md

@@ -0,0 +1,39 @@
+# Diff AI MCP Server
+
+> By [MEOK AI Labs](https://meok.ai) — Compare texts and show differences with detailed change analysis
+
+## Installation
+
+```bash
+pip install diff-ai-mcp
+```
+
+## Usage
+
+```bash
+python server.py
+```
+
+## Tools
+
+### `diff_texts`
+Compare two texts and show line-by-line differences.
+
+**Parameters:**
+- `text_a` (str): First text
+- `text_b` (str): Second text
+
+### `diff_summary`
+Generate a summary of differences between two texts.
+
+**Parameters:**
+- `text_a` (str): First text
+- `text_b` (str): Second text
+
+## Authentication
+
+Free tier: 30 calls/day. Upgrade at [meok.ai/pricing](https://meok.ai/pricing) for unlimited access.
+
+## License
+
+MIT — MEOK AI Labs

diff_ai_mcp-1.0.0/glama.json

@@ -0,0 +1,10 @@
+{
+  "name": "diff-ai-mcp",
+  "description": "MEOK AI Labs \u2014 diff-ai-mcp",
+  "vendor": "MEOK AI Labs",
+  "homepage": "https://meok.ai",
+  "repository": "https://github.com/CSOAI-ORG/diff-ai-mcp",
+  "license": "MIT",
+  "runtime": "python",
+  "entryPoint": "mcp-wrapper.py"
+}

diff_ai_mcp-1.0.0/mcp-wrapper.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""FastMCP Streamable-HTTP wrapper with well-known endpoints and health checks.
+
+Usage:
+    python /path/to/mcp-streamable-http-wrapper.py
+
+This imports `mcp` from `server.py`, mounts discovery endpoints, and runs
+with transport='streamable-http'.
+"""
+
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
+sys.path.insert(0, os.getcwd())
+
+from starlette.requests import Request
+from starlette.responses import JSONResponse, Response
+from server import mcp as mcp_server
+
+
+SERVICE_NAME = os.path.basename(os.getcwd())
+REPO_URL = f"https://github.com/CSOAI-ORG/{SERVICE_NAME}"
+
+
+@mcp_server.custom_route("/.well-known/mcp/server-card.json", methods=["GET"])
+async def server_card(request: Request) -> Response:
+    return JSONResponse(
+        {
+            "$schema": "https://schema.smithery.ai/server-card.json",
+            "version": "1.0.0",
+            "protocolVersion": "2025-11-25",
+            "serverInfo": {
+                "name": SERVICE_NAME,
+                "description": f"MEOK AI Labs — {SERVICE_NAME}",
+                "vendor": "MEOK AI Labs",
+                "homepage": "https://meok.ai",
+                "repository": REPO_URL,
+            },
+            "transport": {
+                "type": "streamable-http",
+                "url": "http://localhost:8000/mcp",
+            },
+            "capabilities": {
+                "tools": {"listChanged": False},
+                "resources": {"listChanged": False},
+                "prompts": {"listChanged": False},
+            },
+        },
+        headers={
+            "Access-Control-Allow-Origin": "*",
+            "Cache-Control": "public, max-age=3600",
+        },
+    )
+
+
+@mcp_server.custom_route("/.well-known/mcp", methods=["GET"])
+async def mcp_manifest(request: Request) -> Response:
+    return JSONResponse(
+        {
+            "mcp_version": "2025-11-25",
+            "endpoints": [
+                {
+                    "type": "streamable-http",
+                    "path": "/mcp",
+                    "url": "http://localhost:8000/mcp",
+                }
+            ],
+        },
+        headers={
+            "Access-Control-Allow-Origin": "*",
+            "Cache-Control": "public, max-age=3600",
+        },
+    )
+
+
+@mcp_server.custom_route("/health", methods=["GET"])
+async def health(request: Request) -> Response:
+    return JSONResponse({"status": "ok"})
+
+
+if __name__ == "__main__":
+    mcp_server.settings.host = "0.0.0.0"
+    mcp_server.run(transport="streamable-http")

diff_ai_mcp-1.0.0/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "diff-ai-mcp",
+  "version": "1.0.0",
+  "description": "AI-powered diff ai MCP server for agents. Supports diff texts, diff summary, word diff. By MEOK AI Labs.",
+  "author": "MEOK AI Labs",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CSOAI-ORG/diff-ai-mcp"
+  }
+}

diff_ai_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "diff-ai-mcp"
+version = "1.0.0"
+description = "AI-powered diff ai MCP server for agents. Supports diff texts, diff summary, word diff. By MEOK AI Labs."
+license = {file = "LICENSE"}
+requires-python = ">=3.10"
+authors = [{name = "MEOK AI Labs", email = "nicholas@meok.ai"}]
+dependencies = ["mcp>=1.0.0"]
+keywords = ["mcp", "ai", "meok", "diff"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries",
+]
+[project.urls]
+Homepage = "https://meok.ai"
+Repository = "https://github.com/CSOAI-ORG/diff-ai-mcp"
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+only-include = ["server.py"]
+
+[project.scripts]
+diff_ai_mcp = "server:main"

diff_ai_mcp-1.0.0/pytest.ini

@@ -0,0 +1,3 @@
+[pytest]
+testpaths = tests
+python_files = test_*.py

diff_ai_mcp-1.0.0/server.py

@@ -0,0 +1,242 @@
+#!/usr/bin/env python3
+"""Compare texts, generate diffs, and create/apply patches. — 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 json, difflib, hashlib
+from datetime import datetime, timezone
+from collections import defaultdict
+from mcp.server.fastmcp import FastMCP
+
+FREE_DAILY_LIMIT = 30
+_usage = defaultdict(list)
+def _rl(c="anon"):
+    now = datetime.now(timezone.utc)
+    _usage[c] = [t for t in _usage[c] if (now - t).total_seconds() < 86400]
+    if len(_usage[c]) >= FREE_DAILY_LIMIT:
+        return json.dumps({"error": f"Limit {FREE_DAILY_LIMIT}/day. Upgrade: meok.ai"})
+    _usage[c].append(now)
+    return None
+
+mcp = FastMCP("diff-ai", instructions="Compare texts, generate unified/context diffs, and create/apply patches. By MEOK AI Labs.")
+
+
+@mcp.tool()
+def diff_texts(text_a: str, text_b: str, context_lines: int = 3, label_a: str = "original", label_b: str = "modified", api_key: str = "") -> str:
+    """Generate a unified diff between two text inputs."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return json.dumps({"error": msg, "upgrade_url": "https://meok.ai/pricing"})
+    if err := _rl():
+        return err
+
+    lines_a = text_a.splitlines(keepends=True)
+    lines_b = text_b.splitlines(keepends=True)
+    context_lines = max(0, min(context_lines, 20))
+
+    unified = list(difflib.unified_diff(lines_a, lines_b, fromfile=label_a, tofile=label_b, n=context_lines))
+    unified_str = ''.join(unified)
+
+    additions = sum(1 for line in unified if line.startswith('+') and not line.startswith('+++'))
+    deletions = sum(1 for line in unified if line.startswith('-') and not line.startswith('---'))
+
+    ratio = difflib.SequenceMatcher(None, text_a, text_b).ratio()
+
+    return json.dumps({
+        "diff": unified_str,
+        "additions": additions,
+        "deletions": deletions,
+        "total_changes": additions + deletions,
+        "similarity": round(ratio, 4),
+        "lines_a": len(lines_a),
+        "lines_b": len(lines_b),
+        "identical": text_a == text_b,
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+    })
+
+
+@mcp.tool()
+def diff_files(content_a: str, content_b: str, filename_a: str = "file_a", filename_b: str = "file_b", output_format: str = "unified", api_key: str = "") -> str:
+    """Generate a diff between two file contents in unified, context, or ndiff format."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return json.dumps({"error": msg, "upgrade_url": "https://meok.ai/pricing"})
+    if err := _rl():
+        return err
+
+    lines_a = content_a.splitlines(keepends=True)
+    lines_b = content_b.splitlines(keepends=True)
+    output_format = output_format.lower().strip()
+
+    if output_format == "context":
+        diff_lines = list(difflib.context_diff(lines_a, lines_b, fromfile=filename_a, tofile=filename_b))
+    elif output_format == "ndiff":
+        diff_lines = list(difflib.ndiff(lines_a, lines_b))
+    elif output_format == "html":
+        differ = difflib.HtmlDiff()
+        html_table = differ.make_table(
+            lines_a, lines_b,
+            fromdesc=filename_a, todesc=filename_b,
+            context=True, numlines=3
+        )
+        return json.dumps({
+            "format": "html",
+            "html": html_table,
+            "lines_a": len(lines_a),
+            "lines_b": len(lines_b),
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+        })
+    else:
+        diff_lines = list(difflib.unified_diff(lines_a, lines_b, fromfile=filename_a, tofile=filename_b))
+
+    diff_str = ''.join(diff_lines)
+    hash_a = hashlib.sha256(content_a.encode()).hexdigest()[:16]
+    hash_b = hashlib.sha256(content_b.encode()).hexdigest()[:16]
+
+    hunks = 0
+    for line in diff_lines:
+        if line.startswith('@@') or line.startswith('***'):
+            hunks += 1
+
+    return json.dumps({
+        "format": output_format,
+        "diff": diff_str,
+        "hunks": hunks,
+        "lines_a": len(lines_a),
+        "lines_b": len(lines_b),
+        "hash_a": hash_a,
+        "hash_b": hash_b,
+        "identical": content_a == content_b,
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+    })
+
+
+@mcp.tool()
+def generate_patch(original: str, modified: str, filename: str = "file.txt", api_key: str = "") -> str:
+    """Generate a patch file from original and modified text that can be applied with the apply_patch tool."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return json.dumps({"error": msg, "upgrade_url": "https://meok.ai/pricing"})
+    if err := _rl():
+        return err
+
+    lines_orig = original.splitlines(keepends=True)
+    lines_mod = modified.splitlines(keepends=True)
+
+    if not lines_orig or not lines_orig[-1].endswith('\n'):
+        lines_orig = [l if l.endswith('\n') else l + '\n' for l in original.splitlines()]
+    if not lines_mod or not lines_mod[-1].endswith('\n'):
+        lines_mod = [l if l.endswith('\n') else l + '\n' for l in modified.splitlines()]
+
+    patch_lines = list(difflib.unified_diff(
+        lines_orig, lines_mod,
+        fromfile=f"a/{filename}",
+        tofile=f"b/{filename}",
+        n=3
+    ))
+    patch_str = ''.join(patch_lines)
+
+    additions = sum(1 for l in patch_lines if l.startswith('+') and not l.startswith('+++'))
+    deletions = sum(1 for l in patch_lines if l.startswith('-') and not l.startswith('---'))
+    hunks = sum(1 for l in patch_lines if l.startswith('@@'))
+
+    return json.dumps({
+        "patch": patch_str,
+        "filename": filename,
+        "hunks": hunks,
+        "additions": additions,
+        "deletions": deletions,
+        "original_lines": len(lines_orig),
+        "modified_lines": len(lines_mod),
+        "patch_size_bytes": len(patch_str.encode()),
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+    })
+
+
+@mcp.tool()
+def apply_patch(original: str, patch_text: str, api_key: str = "") -> str:
+    """Apply a unified diff patch to the original text and return the result."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return json.dumps({"error": msg, "upgrade_url": "https://meok.ai/pricing"})
+    if err := _rl():
+        return err
+
+    original_lines = original.splitlines(keepends=True)
+    if original_lines and not original_lines[-1].endswith('\n'):
+        original_lines[-1] += '\n'
+
+    patch_lines = patch_text.splitlines(keepends=True)
+
+    result_lines = list(original_lines)
+    hunks = []
+    current_hunk = None
+
+    for line in patch_lines:
+        if line.startswith('@@'):
+            import re
+            match = re.match(r'^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@', line)
+            if match:
+                if current_hunk:
+                    hunks.append(current_hunk)
+                current_hunk = {
+                    "orig_start": int(match.group(1)) - 1,
+                    "orig_count": int(match.group(2) or 1),
+                    "new_start": int(match.group(3)) - 1,
+                    "new_count": int(match.group(4) or 1),
+                    "removals": [],
+                    "additions": [],
+                }
+        elif current_hunk is not None:
+            if line.startswith('-') and not line.startswith('---'):
+                current_hunk["removals"].append(line[1:])
+            elif line.startswith('+') and not line.startswith('+++'):
+                current_hunk["additions"].append(line[1:])
+
+    if current_hunk:
+        hunks.append(current_hunk)
+
+    offset = 0
+    applied_hunks = 0
+    failed_hunks = 0
+
+    for hunk in hunks:
+        start = hunk["orig_start"] + offset
+        removals = hunk["removals"]
+        additions = hunk["additions"]
+
+        can_apply = True
+        for i, rem_line in enumerate(removals):
+            idx = start + i
+            if idx >= len(result_lines):
+                can_apply = False
+                break
+            if result_lines[idx].rstrip('\n') != rem_line.rstrip('\n'):
+                can_apply = False
+                break
+
+        if can_apply:
+            result_lines[start:start + len(removals)] = additions
+            offset += len(additions) - len(removals)
+            applied_hunks += 1
+        else:
+            failed_hunks += 1
+
+    result_text = ''.join(result_lines)
+
+    return json.dumps({
+        "result": result_text,
+        "applied_hunks": applied_hunks,
+        "failed_hunks": failed_hunks,
+        "total_hunks": len(hunks),
+        "success": failed_hunks == 0,
+        "original_lines": len(original_lines),
+        "result_lines": len(result_lines),
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+    })
+
+
+if __name__ == "__main__":
+    mcp.run()

diff_ai_mcp-1.0.0/smithery.yaml

@@ -0,0 +1,41 @@
+name: diff-ai-mcp
+description: AI-powered diff ai MCP server for agents. Supports diff texts, diff summary,
+  word diff. By MEOK AI Labs.
+version: 1.0.0
+tools:
+- name: diff_texts
+  description: MEOK AI Labs tool.
+  parameters:
+  - name: text_a
+    type: string
+    required: true
+  - name: text_b
+    type: string
+    required: true
+- name: diff_summary
+  description: MEOK AI Labs tool.
+  parameters:
+  - name: text_a
+    type: string
+    required: true
+  - name: text_b
+    type: string
+    required: true
+- name: word_diff
+  description: MEOK AI Labs tool.
+  parameters:
+  - name: text_a
+    type: string
+    required: true
+  - name: text_b
+    type: string
+    required: true
+- name: similarity_score
+  description: MEOK AI Labs tool.
+  parameters:
+  - name: text_a
+    type: string
+    required: true
+  - name: text_b
+    type: string
+    required: true

diff_ai_mcp-1.0.0/tests/test_server.py

@@ -0,0 +1,47 @@
+import os
+import sys
+import unittest
+
+# Ensure shared auth middleware is available
+sys.path.insert(0, os.path.expanduser("~/clawd/meok-labs-engine/shared"))
+os.chdir(os.path.dirname(os.path.abspath(__file__)) + "/..")
+
+
+class TestMCPImport(unittest.TestCase):
+    def test_import_server(self):
+        """Server module must import without errors."""
+        import server  # noqa: F401
+
+    def test_mcp_or_server_object_exists(self):
+        """FastMCP servers export 'mcp'; low-level servers export 'server'."""
+        import server as srv
+        self.assertTrue(
+            hasattr(srv, "mcp") or hasattr(srv, "server"),
+            "Expected 'mcp' or 'server' object in server.py",
+        )
+
+
+class TestAuthMiddleware(unittest.TestCase):
+    def test_check_access_blocks_empty_key(self):
+        """Empty API key should be rejected on free tier."""
+        from auth_middleware import check_access
+        allowed, msg, tier = check_access("")
+        self.assertFalse(allowed)
+        self.assertIn("upgrade", msg.lower() or tier.lower())
+
+
+class TestHealthEndpoint(unittest.TestCase):
+    def test_health_url_resolves(self):
+        """Wrapper must expose /health."""
+        import urllib.request
+        # Note: this test requires the wrapper to be running on port 8000.
+        # It is skipped in CI unless the server is active.
+        try:
+            resp = urllib.request.urlopen("http://localhost:8000/health", timeout=2)
+            self.assertEqual(resp.status, 200)
+        except Exception as e:
+            self.skipTest(f"Server not running: {e}")
+
+
+if __name__ == "__main__":
+    unittest.main()