markdown-ai-mcp 1.0.0__tar.gz

markdown_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@96b4a1ef7235a096b17240c259729fdd70c83d45 # v2
+        with:
+          subject-name: ${{ github.repository }}
+          subject-digest: sha256:${{ github.sha }}
+          push-to-registry: false

markdown_ai_mcp-1.0.0/.gitignore

@@ -0,0 +1,4 @@
+__pycache__/
+*.pyc
+.env
+*.db

markdown_ai_mcp-1.0.0/.mcp.json

@@ -0,0 +1,77 @@
+{
+  "name": "markdown-ai-mcp",
+  "description": "Markdown Ai MCP server. Tools: convert to html, generate toc, lint markdown. Built by MEOK AI Labs.",
+  "version": "1.0.0",
+  "tools": [
+    {
+      "name": "convert_to_html",
+      "description": "Convert Markdown to HTML (supports headers, bold, italic, links, code, lists).",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "markdown": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "markdown"
+        ]
+      }
+    },
+    {
+      "name": "generate_toc",
+      "description": "Generate a table of contents from Markdown headers.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "markdown": {
+            "type": "string"
+          },
+          "max_depth": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "markdown"
+        ]
+      }
+    },
+    {
+      "name": "lint_markdown",
+      "description": "Lint Markdown for common issues.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "markdown": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "markdown"
+        ]
+      }
+    },
+    {
+      "name": "format_table",
+      "description": "Format data as a Markdown table. headers: comma-separated. rows: semicolon-separated rows of comma-separated values. alignment: L/C/R per column.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "headers": {
+            "type": "string"
+          },
+          "rows": {
+            "type": "string"
+          },
+          "alignment": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "headers",
+          "rows"
+        ]
+      }
+    }
+  ]
+}

markdown_ai_mcp-1.0.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,18 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our project a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at nicholas@meok.ai.
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

markdown_ai_mcp-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to MEOK AI Labs MCP Servers
+
+Thank you for your interest in contributing!
+
+## How to Contribute
+
+1. Fork the repository.
+2. Create a feature branch (`git checkout -b feature/amazing-feature`).
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`).
+4. Push to the branch (`git push origin feature/amazing-feature`).
+5. Open a Pull Request.
+
+## Code Style
+
+- Follow PEP 8 for Python code.
+- Keep tool interfaces backward-compatible when possible.
+- Add tests for new functionality.
+
+## Questions?
+
+Reach out at nicholas@meok.ai.

markdown_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"]

markdown_ai_mcp-1.0.0/LICENSE

@@ -0,0 +1,4 @@
+MIT License
+Copyright (c) 2026 MEOK AI Labs (meok.ai)
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software to deal in the Software without restriction.
+THE SOFTWARE IS PROVIDED "AS IS".

markdown_ai_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: markdown-ai-mcp
+Version: 1.0.0
+Summary: Markdown Ai MCP server. Tools: convert to html, generate toc, lint markdown. Built by MEOK AI Labs.
+Project-URL: Homepage, https://meok.ai
+Project-URL: Repository, https://github.com/CSOAI-ORG/markdown-ai-mcp
+Author-email: MEOK AI Labs <nicholas@meok.ai>
+License: MIT License
+        Copyright (c) 2026 MEOK AI Labs (meok.ai)
+        Permission is hereby granted, free of charge, to any person obtaining a copy of this software to deal in the Software without restriction.
+        THE SOFTWARE IS PROVIDED "AS IS".
+License-File: LICENSE
+Keywords: ai,markdown,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

markdown_ai_mcp-1.0.0/README.md

@@ -0,0 +1,52 @@
+# Markdown AI
+
+> By [MEOK AI Labs](https://meok.ai) — Markdown processing, conversion, and linting tools
+
+## Installation
+
+```bash
+pip install markdown-ai-mcp
+```
+
+## Usage
+
+```bash
+python server.py
+```
+
+## Tools
+
+### `convert_to_html`
+Convert Markdown to HTML (supports headers, bold, italic, links, code, lists).
+
+**Parameters:**
+- `markdown` (str): Markdown text to convert
+
+### `generate_toc`
+Generate a table of contents from Markdown headers.
+
+**Parameters:**
+- `markdown` (str): Markdown text
+- `max_depth` (int): Maximum heading depth (default: 3)
+
+### `lint_markdown`
+Lint Markdown for common issues (line length, trailing whitespace, heading spacing, tabs, broken links).
+
+**Parameters:**
+- `markdown` (str): Markdown text to lint
+
+### `format_table`
+Format data as a Markdown table.
+
+**Parameters:**
+- `headers` (str): Comma-separated column headers
+- `rows` (str): Semicolon-separated rows of comma-separated values
+- `alignment` (str): L/C/R per column
+
+## Authentication
+
+Free tier: 15 calls/day. Upgrade at [meok.ai/pricing](https://meok.ai/pricing) for unlimited access.
+
+## License
+
+MIT — MEOK AI Labs

markdown_ai_mcp-1.0.0/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 1.0.x   | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability, please report it privately to:
+
+- **Email:** nicholas@meok.ai
+- **Organization:** MEOK AI Labs
+
+We aim to respond within 48 hours and will coordinate disclosure responsibly.

markdown_ai_mcp-1.0.0/glama.json

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

markdown_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")

markdown_ai_mcp-1.0.0/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "markdown-ai-mcp",
+  "version": "1.0.0",
+  "description": "Markdown Ai MCP server. Tools: convert to html, generate toc, lint markdown. Built by MEOK AI Labs.",
+  "main": "server.py",
+  "mcp": {
+    "name": "markdown",
+    "vendor": "MEOK AI Labs",
+    "homepage": "https://meok.ai",
+    "repository": "https://github.com/CSOAI-ORG/markdown-ai-mcp",
+    "runtime": "python",
+    "tags": [
+      "mcp",
+      "mcp-server",
+      "meok-ai-labs",
+      "ai-tools"
+    ]
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "meok-ai-labs"
+  ],
+  "author": "MEOK AI Labs <nicholas@meok.ai>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CSOAI-ORG/markdown-ai-mcp"
+  }
+}

markdown_ai_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "markdown-ai-mcp"
+version = "1.0.0"
+description = "Markdown Ai MCP server. Tools: convert to html, generate toc, lint markdown. Built 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", "markdown"]
+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/markdown-ai-mcp"
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+only-include = ["server.py"]
+
+[project.scripts]
+markdown_ai_mcp = "server:main"

markdown_ai_mcp-1.0.0/pytest.ini

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

markdown_ai_mcp-1.0.0/server.py

@@ -0,0 +1,198 @@
+"""Markdown AI MCP Server — Markdown processing tools."""
+
+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
+from typing import Any
+from mcp.server.fastmcp import FastMCP
+
+import json
+from datetime import datetime, timezone
+from collections import defaultdict
+
+FREE_DAILY_LIMIT = 15
+_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"})
+    _usage[c].append(now); return None
+
+
+mcp = FastMCP("markdown-ai", instructions="MEOK AI Labs MCP Server")
+_calls: dict[str, list[float]] = {}
+DAILY_LIMIT = 50
+
+def _rate_check(tool: str) -> bool:
+    now = time.time()
+    _calls.setdefault(tool, [])
+    _calls[tool] = [t for t in _calls[tool] if t > now - 86400]
+    if len(_calls[tool]) >= DAILY_LIMIT:
+        return False
+    _calls[tool].append(now)
+    return True
+
+@mcp.tool()
+def convert_to_html(markdown: str, api_key: str = "") -> dict[str, Any]:
+    """Convert Markdown to HTML (supports headers, bold, italic, links, code, lists)."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+    if err := _rl(): return err
+
+    if not _rate_check("convert_to_html"):
+        return {"error": "Rate limit exceeded (50/day)"}
+    html = markdown
+    # Code blocks first
+    html = re.sub(r'```(\w*)\n(.*?)```', lambda m: f'<pre><code class="language-{m.group(1)}">{m.group(2)}</code></pre>', html, flags=re.DOTALL)
+    html = re.sub(r'`([^`]+)`', r'<code>\1</code>', html)
+    # Headers
+    for i in range(6, 0, -1):
+        html = re.sub(rf'^{"#" * i}\s+(.+)$', rf'<h{i}>\1</h{i}>', html, flags=re.MULTILINE)
+    # Bold and italic
+    html = re.sub(r'\*\*\*(.+?)\*\*\*', r'<strong><em>\1</em></strong>', html)
+    html = re.sub(r'\*\*(.+?)\*\*', r'<strong>\1</strong>', html)
+    html = re.sub(r'\*(.+?)\*', r'<em>\1</em>', html)
+    # Links and images
+    html = re.sub(r'!\[([^\]]*)\]\(([^)]+)\)', r'<img src="\2" alt="\1">', html)
+    html = re.sub(r'\[([^\]]+)\]\(([^)]+)\)', r'<a href="\2">\1</a>', html)
+    # Horizontal rule
+    html = re.sub(r'^---+$', '<hr>', html, flags=re.MULTILINE)
+    # Blockquote
+    html = re.sub(r'^>\s*(.+)$', r'<blockquote>\1</blockquote>', html, flags=re.MULTILINE)
+    # Unordered lists
+    lines = html.split("\n")
+    result, in_ul, in_ol = [], False, False
+    for line in lines:
+        ul_match = re.match(r'^[\-\*]\s+(.+)$', line)
+        ol_match = re.match(r'^\d+\.\s+(.+)$', line)
+        if ul_match:
+            if not in_ul:
+                result.append("<ul>")
+                in_ul = True
+            result.append(f"  <li>{ul_match.group(1)}</li>")
+        elif ol_match:
+            if not in_ol:
+                result.append("<ol>")
+                in_ol = True
+            result.append(f"  <li>{ol_match.group(1)}</li>")
+        else:
+            if in_ul:
+                result.append("</ul>")
+                in_ul = False
+            if in_ol:
+                result.append("</ol>")
+                in_ol = False
+            if line.strip():
+                result.append(f"<p>{line}</p>" if not line.startswith("<") else line)
+            else:
+                result.append("")
+    if in_ul: result.append("</ul>")
+    if in_ol: result.append("</ol>")
+    html_out = "\n".join(result)
+    return {"html": html_out, "input_length": len(markdown), "output_length": len(html_out)}
+
+@mcp.tool()
+def generate_toc(markdown: str, max_depth: int = 3, api_key: str = "") -> dict[str, Any]:
+    """Generate a table of contents from Markdown headers."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+    if err := _rl(): return err
+
+    if not _rate_check("generate_toc"):
+        return {"error": "Rate limit exceeded (50/day)"}
+    headers = []
+    for line in markdown.split("\n"):
+        m = re.match(r'^(#{1,6})\s+(.+)$', line)
+        if m:
+            level = len(m.group(1))
+            if level <= max_depth:
+                text = m.group(2).strip()
+                slug = re.sub(r'[^\w\s-]', '', text.lower()).replace(' ', '-')
+                headers.append({"level": level, "text": text, "slug": slug})
+    toc_lines = []
+    for h in headers:
+        indent = "  " * (h["level"] - 1)
+        toc_lines.append(f'{indent}- [{h["text"]}](#{h["slug"]})')
+    return {"toc": "\n".join(toc_lines), "headers": headers, "header_count": len(headers)}
+
+@mcp.tool()
+def lint_markdown(markdown: str, api_key: str = "") -> dict[str, Any]:
+    """Lint Markdown for common issues."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+    if err := _rl(): return err
+
+    if not _rate_check("lint_markdown"):
+        return {"error": "Rate limit exceeded (50/day)"}
+    issues = []
+    lines = markdown.split("\n")
+    for i, line in enumerate(lines, 1):
+        if len(line) > 120:
+            issues.append({"line": i, "rule": "line-length", "message": f"Line exceeds 120 chars ({len(line)})"})
+        if line.rstrip() != line:
+            issues.append({"line": i, "rule": "trailing-whitespace", "message": "Trailing whitespace"})
+        if re.match(r'^#+[^\s]', line):
+            issues.append({"line": i, "rule": "heading-space", "message": "No space after heading marker"})
+        if '\t' in line:
+            issues.append({"line": i, "rule": "no-tabs", "message": "Tab character found (use spaces)"})
+    # Check for multiple blank lines
+    for i in range(len(lines) - 1):
+        if lines[i].strip() == "" and (i + 1 < len(lines) and lines[i + 1].strip() == ""):
+            issues.append({"line": i + 1, "rule": "no-multiple-blanks", "message": "Multiple consecutive blank lines"})
+    # Check for broken links
+    for i, line in enumerate(lines, 1):
+        for m in re.finditer(r'\[([^\]]*)\]\(([^)]*)\)', line):
+            if not m.group(2):
+                issues.append({"line": i, "rule": "no-empty-links", "message": f"Empty link URL for '{m.group(1)}'"})
+    severity = "clean" if not issues else "warning" if len(issues) < 5 else "needs-attention"
+    return {"issues": issues, "issue_count": len(issues), "severity": severity, "line_count": len(lines)}
+
+@mcp.tool()
+def format_table(headers: str, rows: str, alignment: str = "", api_key: str = "") -> dict[str, Any]:
+    """Format data as a Markdown table. headers: comma-separated. rows: semicolon-separated rows of comma-separated values. alignment: L/C/R per column."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+    if err := _rl(): return err
+
+    if not _rate_check("format_table"):
+        return {"error": "Rate limit exceeded (50/day)"}
+    cols = [h.strip() for h in headers.split(",")]
+    data_rows = [[c.strip() for c in row.split(",")] for row in rows.split(";") if row.strip()]
+    aligns = list(alignment.upper()) if alignment else ["L"] * len(cols)
+    while len(aligns) < len(cols):
+        aligns.append("L")
+    widths = [len(c) for c in cols]
+    for row in data_rows:
+        for i, cell in enumerate(row):
+            if i < len(widths):
+                widths[i] = max(widths[i], len(cell))
+    def pad(text, width, align):
+        if align == "C": return text.center(width)
+        if align == "R": return text.rjust(width)
+        return text.ljust(width)
+    header_line = "| " + " | ".join(pad(c, widths[i], aligns[i]) for i, c in enumerate(cols)) + " |"
+    sep_parts = []
+    for i, w in enumerate(widths):
+        if aligns[i] == "C": sep_parts.append(":" + "-" * (w) + ":")
+        elif aligns[i] == "R": sep_parts.append("-" * (w + 1) + ":")
+        else: sep_parts.append(":" + "-" * (w + 1))
+    sep_line = "| " + " | ".join(sep_parts) + " |"
+    row_lines = []
+    for row in data_rows:
+        padded = []
+        for i in range(len(cols)):
+            val = row[i] if i < len(row) else ""
+            padded.append(pad(val, widths[i], aligns[i]))
+        row_lines.append("| " + " | ".join(padded) + " |")
+    table = "\n".join([header_line, sep_line] + row_lines)
+    return {"table": table, "columns": len(cols), "rows": len(data_rows)}
+
+if __name__ == "__main__":
+    mcp.run()

markdown_ai_mcp-1.0.0/smithery.yaml

@@ -0,0 +1,40 @@
+name: markdown-ai-mcp
+description: 'Markdown Ai MCP server. Tools: convert to html, generate toc, lint markdown.
+  Built by MEOK AI Labs.'
+version: 1.0.0
+tools:
+- name: convert_to_html
+  description: Convert Markdown to HTML (supports headers, bold, italic, links, code,
+    lists).
+  parameters:
+  - name: markdown
+    type: string
+    required: true
+- name: generate_toc
+  description: Generate a table of contents from Markdown headers.
+  parameters:
+  - name: markdown
+    type: string
+    required: true
+  - name: max_depth
+    type: integer
+    required: false
+- name: lint_markdown
+  description: Lint Markdown for common issues.
+  parameters:
+  - name: markdown
+    type: string
+    required: true
+- name: format_table
+  description: 'Format data as a Markdown table. headers: comma-separated. rows: semicolon-separated
+    rows of comma-separated values. alignment: L/C/R per column.'
+  parameters:
+  - name: headers
+    type: string
+    required: true
+  - name: rows
+    type: string
+    required: true
+  - name: alignment
+    type: string
+    required: false

markdown_ai_mcp-1.0.0/tests/test_server.py

@@ -0,0 +1,55 @@
+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_allows_empty_key_as_free_tier(self):
+        """Empty API key maps to FREE tier and is allowed."""
+        from auth_middleware import check_access, Tier
+        allowed, msg, tier = check_access("")
+        self.assertTrue(allowed)
+        self.assertEqual(tier, Tier.FREE)
+        self.assertIsInstance(msg, str)
+
+    def test_check_access_returns_tuple(self):
+        """check_access must return a 3-tuple."""
+        from auth_middleware import check_access
+        result = check_access("")
+        self.assertIsInstance(result, tuple)
+        self.assertEqual(len(result), 3)
+
+
+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()