Code Explainer MCP Server

What is Code Explainer MCP?

Code Explainer MCP is a Cloudflare Worker that analyzes source code snippets and returns a Markdown report containing an ASCII architecture diagram, a core-functionality summary, and a breakdown of main classes and functions. It uses only regex and pattern matching—no LLM calls or external dependencies—and supports JavaScript, TypeScript, Python, Java, and C# with a generic fallback.

How to use Code Explainer MCP?

Deploy the Worker to Cloudflare, set the SHARED_SECRET secret, then send a POST request to the Worker URL with a JSON body containing "method": "explainCode" and "params": [code, language]. Include the bearer token in the Authorization: Bearer <SHARED_SECRET> header. For local development, run npm run dev after setting the secret in .dev.vars.

Key features of Code Explainer MCP

• Generates ASCII architecture diagrams showing classes, functions, and call relationships.
• Infers primary and secondary code purpose from weighted pattern matches.
• Extracts main components with descriptions, reusing existing doc comments when available.
• Supports JavaScript, TypeScript, Python, Java, C#, and a generic fallback.
• Bearer-token authentication with constant-time comparison; fails closed if unconfigured.
• Runs entirely inside Cloudflare Workers with no external runtime dependencies.

Use cases of Code Explainer MCP

• Quickly understand an unfamiliar codebase or snippet without an LLM.
• Auto-generate documentation for small to medium code modules.
• Provide architecture summaries in code review or onboarding contexts.
• Enable programmatic code analysis in CI pipelines with a lightweight HTTP endpoint.