mesh-mcp 0.1.0__tar.gz

mesh_mcp-0.1.0/.gitignore

@@ -0,0 +1,39 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+env/
+
+# IDE / Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing / Cache
+.pytest_cache/
+.coverage
+htmlcov/

mesh_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nagachaitanya Inamdar
+
+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.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mesh_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.5
+Name: mesh-mcp
+Version: 0.1.0
+Summary: Cross-boundary contract blast-radius engine for LLM coding agents
+Project-URL: Homepage, https://github.com/Nagachaitanya007/mesh-mcp
+Project-URL: Repository, https://github.com/Nagachaitanya007/mesh-mcp
+Author-email: Nagachaitanya <nagachaitanyainamdar@gmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+# mesh-mcp
+
+Cross-boundary contract blast-radius engine for LLM coding agents.
+
+Helps AI agents detect what breaks when you change an API contract or schema.
+
+## Install
+
+```bash
+pip install mesh-mcp

mesh_mcp-0.1.0/README.md

@@ -0,0 +1,10 @@
+# mesh-mcp
+
+Cross-boundary contract blast-radius engine for LLM coding agents.
+
+Helps AI agents detect what breaks when you change an API contract or schema.
+
+## Install
+
+```bash
+pip install mesh-mcp

mesh_mcp-0.1.0/models.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel
+
+class Order(BaseModel):
+    id: str
+    total: float
+    currency: str
+    tax_amount: float | None = None

mesh_mcp-0.1.0/openapi.yaml

@@ -0,0 +1,72 @@
+openapi: 3.0.3
+info:
+  title: Orders API
+  version: 1.0.0
+  description: Sample API for testing mesh-mcp
+
+paths:
+  /orders:
+    get:
+      summary: List orders
+      responses:
+        '200':
+          description: A list of orders
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/Order'
+    post:
+      summary: Create an order
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Order'
+      responses:
+        '201':
+          description: Order created
+
+  /orders/{id}:
+    get:
+      summary: Get an order by ID
+      parameters:
+        - name: id
+          in: path
+          required: true
+          schema:
+            type: string
+      responses:
+        '200':
+          description: An order
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Order'
+
+components:
+  schemas:
+    Order:
+      type: object
+      required:
+        - id
+        - total
+      properties:
+        id:
+          type: string
+        customer_id:
+          type: string
+        total:
+          type: number
+          format: float
+        currency:
+          type: string
+          enum: [USD, EUR, GBP]
+        tax_amount:
+          type: number
+          format: float
+        status:
+          type: string
+          enum: [pending, paid, shipped, cancelled]

mesh_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "mesh-mcp"
+version = "0.1.0"
+description = "Cross-boundary contract blast-radius engine for LLM coding agents"
+readme = "README.md"
+requires-python = ">=3.10"
+license = {text = "MIT"}
+authors = [
+    {name = "Nagachaitanya", email = "nagachaitanyainamdar@gmail.com"}
+]
+dependencies = [
+    "mcp>=1.0.0",
+    "pyyaml>=6.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/Nagachaitanya007/mesh-mcp"
+Repository = "https://github.com/Nagachaitanya007/mesh-mcp"
+
+[project.scripts]
+mesh-mcp = "mesh_mcp.server:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/mesh_mcp"]

mesh_mcp-0.1.0/src/mesh_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""mesh-mcp: Contract blast-radius MCP server."""
+
+__version__ = "0.1.0"

mesh_mcp-0.1.0/src/mesh_mcp/detectors/openapi.py

@@ -0,0 +1,59 @@
+"""OpenAPI contract detector."""
+
+# TODO: Parse OpenAPI / Swagger files
+"""OpenAPI contract detector."""
+
+from pathlib import Path
+import yaml
+import json
+
+
+def find_openapi_files(root: Path) -> list[Path]:
+    """Find OpenAPI / Swagger files in the workspace."""
+    patterns = ["**/openapi.yaml", "**/openapi.yml", "**/openapi.json",
+                "**/swagger.yaml", "**/swagger.yml", "**/swagger.json"]
+    files = []
+    for pattern in patterns:
+        files.extend(root.glob(pattern))
+    # Remove duplicates and ignore common junk
+    unique = []
+    seen = set()
+    for f in files:
+        if f.resolve() not in seen and ".venv" not in str(f) and "node_modules" not in str(f):
+            seen.add(f.resolve())
+            unique.append(f)
+    return unique
+
+
+def parse_openapi(file_path: Path) -> dict | None:
+    """Parse an OpenAPI file and extract basic contract info."""
+    try:
+        text = file_path.read_text(encoding="utf-8")
+        if file_path.suffix in {".yaml", ".yml"}:
+            data = yaml.safe_load(text)
+        else:
+            data = json.loads(text)
+
+        if not isinstance(data, dict):
+            return None
+
+        info = {
+            "file": str(file_path),
+            "title": data.get("info", {}).get("title", file_path.stem),
+            "version": data.get("info", {}).get("version", "unknown"),
+            "schemas": list(data.get("components", {}).get("schemas", {}).keys()),
+            "paths": list(data.get("paths", {}).keys()),
+        }
+        return info
+    except Exception:
+        return None
+
+
+def extract_contracts(root: Path) -> list[dict]:
+    """Find and parse all OpenAPI contracts in the workspace."""
+    contracts = []
+    for file_path in find_openapi_files(root):
+        parsed = parse_openapi(file_path)
+        if parsed:
+            contracts.append(parsed)
+    return contracts

mesh_mcp-0.1.0/src/mesh_mcp/detectors/python_detector.py

@@ -0,0 +1,35 @@
+"""Simple Python consumer detector."""
+
+from pathlib import Path
+import re
+
+
+def find_python_consumers(root: Path, schema_names: list[str]) -> list[dict]:
+    """
+    Find Python files that mention the given schema names.
+    This is a simple text-based detector for the MVP.
+    """
+    consumers = []
+    ignore_dirs = {".venv", "venv", "__pycache__", ".git", "node_modules", "src"}
+
+    for py_file in root.rglob("*.py"):
+        if any(part in ignore_dirs for part in py_file.parts):
+            continue
+
+        try:
+            text = py_file.read_text(encoding="utf-8", errors="ignore")
+        except Exception:
+            continue
+
+        for schema in schema_names:
+            # Simple check: class name or schema name appears
+            if re.search(rf"\b{schema}\b", text):
+                consumers.append({
+                    "file": str(py_file),
+                    "language": "python",
+                    "schema": schema,
+                    "reason": f"Mentions '{schema}'"
+                })
+                break  # one match per file is enough for now
+
+    return consumers

mesh_mcp-0.1.0/src/mesh_mcp/detectors/typescript_detector.py

@@ -0,0 +1,3 @@
+"""TypeScript consumer detector."""
+
+# TODO: Find TypeScript interfaces that reference contracts

mesh_mcp-0.1.0/src/mesh_mcp/graph.py

@@ -0,0 +1,3 @@
+"""Simple in-memory contract graph."""
+
+# TODO: Store producers and consumers

mesh_mcp-0.1.0/src/mesh_mcp/indexer.py

@@ -0,0 +1,3 @@
+"""Workspace indexer for contracts and consumers."""
+
+# TODO: Scan for OpenAPI files and consumer references

mesh_mcp-0.1.0/src/mesh_mcp/server.py

@@ -0,0 +1,138 @@
+from mcp.server.mcpserver import MCPServer
+from pathlib import Path
+import sys
+
+from mesh_mcp.detectors.openapi import extract_contracts
+from mesh_mcp.detectors.python_detector import find_python_consumers
+
+mcp = MCPServer("mesh-mcp")
+
+# Workspace
+if len(sys.argv) > 1:
+    WORKSPACE = Path(sys.argv[1]).resolve()
+else:
+    WORKSPACE = Path.cwd().resolve()
+
+@mcp.tool()
+def list_contracts() -> str:
+    """
+    List all OpenAPI contracts found in the workspace.
+    Use this to see what APIs and schemas are available.
+    """
+    contracts = extract_contracts(WORKSPACE)
+    if not contracts:
+        return "No OpenAPI contracts found in the workspace."
+
+    lines = ["# Detected Contracts\n"]
+    for c in contracts:
+        lines.append(f"## {c['title']} (v{c['version']})")
+        lines.append(f"- File: {c['file']}")
+        if c["schemas"]:
+            lines.append(f"- Schemas: {', '.join(c['schemas'][:10])}")
+        if c["paths"]:
+            lines.append(f"- Paths: {', '.join(c['paths'][:8])}")
+        lines.append("")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+def trace_contract(contract_name: str) -> str:
+    """
+    Trace a specific contract by name (schema or title).
+    Shows where it is defined and basic details.
+    Example: trace_contract("Order")
+    """
+    contracts = extract_contracts(WORKSPACE)
+    matches = []
+
+    for c in contracts:
+        if (contract_name.lower() in c["title"].lower() or
+            contract_name.lower() in [s.lower() for s in c["schemas"]] or
+            any(contract_name.lower() in p.lower() for p in c["paths"])):
+            matches.append(c)
+
+    if not matches:
+        return f"No contract found matching '{contract_name}'."
+
+    lines = [f"# Trace: {contract_name}\n"]
+    for c in matches:
+        lines.append(f"**Defined in:** {c['file']}")
+        lines.append(f"**Title:** {c['title']} (v{c['version']})")
+        if c["schemas"]:
+            lines.append(f"**Schemas:** {', '.join(c['schemas'])}")
+        if c["paths"]:
+            lines.append(f"**Paths:** {', '.join(c['paths'])}")
+        lines.append("")
+    return "\n".join(lines)
+
+
+from mesh_mcp.detectors.python_detector import find_python_consumers
+
+@mcp.tool()
+def find_consumers(schema_name: str) -> str:
+    """
+    Find Python files that appear to consume a given schema.
+    Example: find_consumers("Order")
+    """
+    contracts = extract_contracts(WORKSPACE)
+    all_schemas = []
+    for c in contracts:
+        all_schemas.extend(c["schemas"])
+
+    if schema_name not in all_schemas and not any(schema_name.lower() in s.lower() for s in all_schemas):
+        return f"Schema '{schema_name}' not found in any OpenAPI contract."
+
+    consumers = find_python_consumers(WORKSPACE, [schema_name])
+
+    if not consumers:
+        return f"No Python consumers found for '{schema_name}'."
+
+    lines = [f"# Consumers of {schema_name}\n"]
+    for cons in consumers:
+        lines.append(f"- {cons['file']} ({cons['reason']})")
+    return "\n".join(lines)
+
+
+@mcp.tool()
+def check_blast_radius(schema_name: str, change_description: str = "") -> str:
+    """
+    Check the blast radius of changing a schema.
+    Shows which files may be affected.
+    Example: check_blast_radius("Order", "removed field tax_amount")
+    """
+    contracts = extract_contracts(WORKSPACE)
+    matching = [c for c in contracts if schema_name in c["schemas"] or schema_name.lower() in c["title"].lower()]
+
+    if not matching:
+        return f"Schema '{schema_name}' not found."
+
+    consumers = find_python_consumers(WORKSPACE, [schema_name])
+
+    lines = [f"# Blast Radius: {schema_name}\n"]
+    if change_description:
+        lines.append(f"**Proposed change:** {change_description}\n")
+
+    lines.append("**Defined in:**")
+    for c in matching:
+        lines.append(f"- {c['file']} ({c['title']})")
+
+    lines.append("\n**Potentially affected consumers:**")
+    if consumers:
+        for cons in consumers:
+            # Skip the server file itself for cleaner output
+            if "server.py" in cons["file"]:
+                continue
+            lines.append(f"- {cons['file']} — {cons['reason']}")
+    else:
+        lines.append("- No consumers detected")
+
+    lines.append("\n**Recommendation:** Review the listed files before making breaking changes.")
+    return "\n".join(lines)
+
+
+def main():
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

mesh_mcp-0.1.0/tests/__init__.py

@@ -0,0 +1 @@
+"""Tests for mesh-mcp."""