Mekara

This section covers the structure of the mekara Python MCP server package.

Section Index

• Standard Mekara Project – Project structure, workspace layout, and setup commands.
• Core – Shared architecture: MCP server, script execution, module layout.
• Modules - Module-sized compartmentalization of the codebase
• Hooks – Claude Code hook commands: schemas, examples, and testing.
• CLI – The main CLI entrypoint and argument handling.
• Capabilities – User-facing features:
  • MCP Integration – Running mekara scripts inside Claude Code via MCP.
• Testing – Test suite implementation, VCR recording workflow, and testing utilities.
• Code Conventions – Critical architectural decisions and conventions that must be preserved.
• Scripts – Utility scripts for development and documentation maintenance.
• Refactoring Patterns – Lessons learned: code smells, unnecessary indirection, and when to simplify.
• Coding Standards – Concrete mistakes and their fixes: duplication, naming, imports.