api-docs-generator-ai-mcp 1.0.0__tar.gz

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

@@ -0,0 +1,26 @@
+name: Publish to Smithery
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    name: Publish MCP Server to Smithery
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Publish to Smithery
+        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 }}

api_docs_generator_ai_mcp-1.0.0/.gitignore

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

api_docs_generator_ai_mcp-1.0.0/.mcp.json

@@ -0,0 +1,113 @@
+{
+  "name": "api-docs-generator-ai-mcp",
+  "description": "> **By [MEOK AI Labs](https://meok.ai)** \u2014 Generate OpenAPI/Swagger specifications from natural language API descriptions. Supports REST endpoi",
+  "version": "1.0.0",
+  "tools": [
+    {
+      "name": "generate_endpoint",
+      "description": "Generate an OpenAPI endpoint definition from a description.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "path": {
+            "type": "string"
+          },
+          "method": {
+            "type": "string"
+          },
+          "summary": {
+            "type": "string"
+          },
+          "request_body": {
+            "type": "string"
+          },
+          "response_description": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "path",
+          "method",
+          "summary"
+        ]
+      }
+    },
+    {
+      "name": "generate_schema",
+      "description": "Generate an OpenAPI schema component. Fields format: 'name:type,name2:type2' (types: string,integer,number,boolean,array).",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string"
+          },
+          "fields": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "fields"
+        ]
+      }
+    },
+    {
+      "name": "generate_full_spec",
+      "description": "Generate a complete OpenAPI 3.0 spec. Pass endpoints_json as a JSON array of {path, method, summary} objects.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "title": {
+            "type": "string"
+          },
+          "description": {
+            "type": "string"
+          },
+          "version": {
+            "type": "string"
+          },
+          "endpoints_json": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "description"
+        ]
+      }
+    },
+    {
+      "name": "add_auth_to_spec",
+      "description": "Add authentication scheme to an OpenAPI spec. auth_type: bearer, api_key, basic, oauth2.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "spec_json": {
+            "type": "string"
+          },
+          "auth_type": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "spec_json"
+        ]
+      }
+    },
+    {
+      "name": "validate_spec",
+      "description": "Validate an OpenAPI spec for common issues.",
+      "parameters": {
+        "type": "object",
+        "properties": {
+          "spec_json": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "spec_json"
+        ]
+      }
+    }
+  ]
+}

api_docs_generator_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.

api_docs_generator_ai_mcp-1.0.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: api-docs-generator-ai-mcp
+Version: 1.0.0
+Summary: MEOK AI Labs — api-docs-generator-ai-mcp
+Project-URL: Homepage, https://meok.ai
+Project-URL: Repository, https://github.com/CSOAI-ORG/api-docs-generator-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,api,docs,generator,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

api_docs_generator_ai_mcp-1.0.0/README.md

@@ -0,0 +1,9 @@
+# Api Docs Generator Ai Mcp
+
+api-docs-generator-ai-mcp — Generate API documentation from code.
+
+Built by [MEOK AI Labs](https://meok.ai).
+
+## License
+
+MIT © MEOK AI Labs

api_docs_generator_ai_mcp-1.0.0/package.json

@@ -0,0 +1 @@
+{"name":"api-docs-generator-ai-mcp","version":"1.0.0","description":"MEOK AI Labs MCP","author":"MEOK AI Labs","license":"MIT","repository":{"type":"git","url":"https://github.com/CSOAI-ORG/api-docs-generator-ai-mcp"}}

api_docs_generator_ai_mcp-1.0.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+[project]
+name = "api-docs-generator-ai-mcp"
+version = "1.0.0"
+description = "MEOK AI Labs — api-docs-generator-ai-mcp"
+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", "api", "docs", "generator"]
+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/api-docs-generator-ai-mcp"
+[tool.hatch.build.targets.wheel]
+packages = ["."]
+only-include = ["server.py"]

api_docs_generator_ai_mcp-1.0.0/server.py

@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+"""api-docs-generator-ai-mcp - Generate OpenAPI specs from descriptions."""
+
+import sys, os
+sys.path.insert(0, os.path.expanduser('~/clawd/meok-labs-engine/shared'))
+from auth_middleware import check_access
+
+import json
+import time
+from typing import Optional
+from mcp.server.fastmcp import FastMCP
+
+mcp = FastMCP(
+    "api-docs-generator-ai",
+    instructions="Generate OpenAPI/Swagger specifications from natural language API descriptions. Supports REST endpoint generation, schema creation, and full spec assembly.",
+)
+
+# Rate limiting
+_calls: list[float] = []
+DAILY_LIMIT = 50
+
+
+def _check_rate() -> bool:
+    now = time.time()
+    _calls[:] = [t for t in _calls if now - t < 86400]
+    if len(_calls) >= DAILY_LIMIT:
+        return False
+    _calls.append(now)
+    return True
+
+
+@mcp.tool()
+def generate_endpoint(
+    path: str, method: str, summary: str, request_body: Optional[str] = None, response_description: str = "Successful response"
+, api_key: str = "") -> dict:
+    """Generate an OpenAPI endpoint definition from a description."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if not _check_rate():
+        return {"error": "Rate limit exceeded (50/day)"}
+    method = method.lower()
+    if method not in ("get", "post", "put", "patch", "delete", "head", "options"):
+        return {"error": f"Invalid HTTP method: {method}"}
+    endpoint: dict = {
+        "summary": summary,
+        "operationId": path.strip("/").replace("/", "_").replace("{", "").replace("}", "") + f"_{method}",
+        "responses": {
+            "200": {
+                "description": response_description,
+                "content": {"application/json": {"schema": {"type": "object"}}},
+            },
+            "400": {"description": "Bad request"},
+            "500": {"description": "Internal server error"},
+        },
+    }
+    if request_body and method in ("post", "put", "patch"):
+        fields = [f.strip() for f in request_body.split(",")]
+        properties = {}
+        for field in fields:
+            parts = field.split(":")
+            fname = parts[0].strip()
+            ftype = parts[1].strip() if len(parts) > 1 else "string"
+            properties[fname] = {"type": ftype}
+        endpoint["requestBody"] = {
+            "required": True,
+            "content": {
+                "application/json": {
+                    "schema": {"type": "object", "properties": properties, "required": list(properties.keys())},
+                }
+            },
+        }
+    params = []
+    import re
+    for match in re.finditer(r"\{(\w+)\}", path):
+        params.append({"name": match.group(1), "in": "path", "required": True, "schema": {"type": "string"}})
+    if params:
+        endpoint["parameters"] = params
+    return {"path": path, "method": method, "definition": endpoint}
+
+
+@mcp.tool()
+def generate_schema(name: str, fields: str, api_key: str = "") -> dict:
+    """Generate an OpenAPI schema component. Fields format: 'name:type,name2:type2' (types: string,integer,number,boolean,array)."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if not _check_rate():
+        return {"error": "Rate limit exceeded (50/day)"}
+    properties = {}
+    required = []
+    for field in fields.split(","):
+        parts = field.strip().split(":")
+        fname = parts[0].strip()
+        ftype = parts[1].strip() if len(parts) > 1 else "string"
+        if not fname:
+            continue
+        if ftype == "array":
+            properties[fname] = {"type": "array", "items": {"type": "string"}}
+        else:
+            properties[fname] = {"type": ftype}
+        required.append(fname)
+    schema = {"type": "object", "properties": properties, "required": required}
+    return {"schema_name": name, "schema": schema}
+
+
+@mcp.tool()
+def generate_full_spec(
+    title: str, description: str, version: str = "1.0.0", endpoints_json: str = "[]"
+, api_key: str = "") -> dict:
+    """Generate a complete OpenAPI 3.0 spec. Pass endpoints_json as a JSON array of {path, method, summary} objects."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if not _check_rate():
+        return {"error": "Rate limit exceeded (50/day)"}
+    try:
+        endpoints = json.loads(endpoints_json)
+    except json.JSONDecodeError:
+        return {"error": "Invalid JSON for endpoints_json"}
+    paths: dict = {}
+    for ep in endpoints:
+        p = ep.get("path", "/")
+        m = ep.get("method", "get").lower()
+        s = ep.get("summary", "")
+        if p not in paths:
+            paths[p] = {}
+        paths[p][m] = {
+            "summary": s,
+            "operationId": p.strip("/").replace("/", "_") + f"_{m}",
+            "responses": {"200": {"description": "Success", "content": {"application/json": {"schema": {"type": "object"}}}}},
+        }
+    spec = {
+        "openapi": "3.0.3",
+        "info": {"title": title, "description": description, "version": version},
+        "paths": paths,
+        "components": {"schemas": {}},
+    }
+    return {"spec": spec}
+
+
+@mcp.tool()
+def add_auth_to_spec(spec_json: str, auth_type: str = "bearer", api_key: str = "") -> dict:
+    """Add authentication scheme to an OpenAPI spec. auth_type: bearer, api_key, basic, oauth2."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if not _check_rate():
+        return {"error": "Rate limit exceeded (50/day)"}
+    try:
+        spec = json.loads(spec_json)
+    except json.JSONDecodeError:
+        return {"error": "Invalid JSON for spec"}
+    schemes = {
+        "bearer": {"type": "http", "scheme": "bearer", "bearerFormat": "JWT"},
+        "api_key": {"type": "apiKey", "in": "header", "name": "X-API-Key"},
+        "basic": {"type": "http", "scheme": "basic"},
+        "oauth2": {
+            "type": "oauth2",
+            "flows": {"authorizationCode": {"authorizationUrl": "https://example.com/oauth/authorize", "tokenUrl": "https://example.com/oauth/token", "scopes": {"read": "Read access", "write": "Write access"}}},
+        },
+    }
+    if auth_type not in schemes:
+        return {"error": f"Unknown auth type: {auth_type}. Use: bearer, api_key, basic, oauth2"}
+    if "components" not in spec:
+        spec["components"] = {}
+    spec["components"]["securitySchemes"] = {auth_type: schemes[auth_type]}
+    spec["security"] = [{auth_type: []}]
+    return {"spec": spec}
+
+
+@mcp.tool()
+def validate_spec(spec_json: str, api_key: str = "") -> dict:
+    """Validate an OpenAPI spec for common issues."""
+    allowed, msg, tier = check_access(api_key)
+    if not allowed:
+        return {"error": msg, "upgrade_url": "https://meok.ai/pricing"}
+
+    if not _check_rate():
+        return {"error": "Rate limit exceeded (50/day)"}
+    try:
+        spec = json.loads(spec_json)
+    except json.JSONDecodeError:
+        return {"valid": False, "errors": ["Invalid JSON"]}
+    errors = []
+    warnings = []
+    if "openapi" not in spec:
+        errors.append("Missing 'openapi' version field")
+    if "info" not in spec:
+        errors.append("Missing 'info' object")
+    else:
+        if "title" not in spec["info"]:
+            errors.append("Missing 'info.title'")
+        if "version" not in spec["info"]:
+            errors.append("Missing 'info.version'")
+    if "paths" not in spec:
+        errors.append("Missing 'paths' object")
+    else:
+        for path, methods in spec["paths"].items():
+            if not path.startswith("/"):
+                errors.append(f"Path '{path}' must start with /")
+            for method, definition in methods.items():
+                if method not in ("get", "post", "put", "patch", "delete", "head", "options", "trace"):
+                    errors.append(f"Invalid method '{method}' on {path}")
+                if "responses" not in definition:
+                    warnings.append(f"{method.upper()} {path} has no responses defined")
+    return {"valid": len(errors) == 0, "errors": errors, "warnings": warnings}
+
+
+def main():
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

api_docs_generator_ai_mcp-1.0.0/smithery.yaml

@@ -0,0 +1,65 @@
+name: api-docs-generator-ai-mcp
+description: Generate OpenAPI/Swagger specifications from natural language API descriptions.
+  Supports REST endpoi
+version: 1.0.0
+tools:
+- name: generate_endpoint
+  description: Generate an OpenAPI endpoint definition from a description.
+  parameters:
+  - name: path
+    type: string
+    required: true
+  - name: method
+    type: string
+    required: true
+  - name: summary
+    type: string
+    required: true
+  - name: request_body
+    type: string
+    required: false
+  - name: response_description
+    type: string
+    required: false
+- name: generate_schema
+  description: 'Generate an OpenAPI schema component. Fields format: ''name:type,name2:type2''
+    (types: string,integer,number,boolean,array).'
+  parameters:
+  - name: name
+    type: string
+    required: true
+  - name: fields
+    type: string
+    required: true
+- name: generate_full_spec
+  description: Generate a complete OpenAPI 3.0 spec. Pass endpoints_json as a JSON
+    array of {path, method, summary} objects.
+  parameters:
+  - name: title
+    type: string
+    required: true
+  - name: description
+    type: string
+    required: true
+  - name: version
+    type: string
+    required: false
+  - name: endpoints_json
+    type: string
+    required: false
+- name: add_auth_to_spec
+  description: 'Add authentication scheme to an OpenAPI spec. auth_type: bearer, api_key,
+    basic, oauth2.'
+  parameters:
+  - name: spec_json
+    type: string
+    required: true
+  - name: auth_type
+    type: string
+    required: false
+- name: validate_spec
+  description: Validate an OpenAPI spec for common issues.
+  parameters:
+  - name: spec_json
+    type: string
+    required: true