mcp-module-dev

Develop ADHD Framework MCP modules with standardized scaffolding and templates.

Updated Feb 1, 2026
One-click install
npx skills add https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3 --skill mcp-module-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-module-dev
Source: https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3/tree/main/modules/dev/instruction_core/data/skills/mcp-module-dev
Command: npx skills add https://github.com/AI-Driven-Highspeed-Development/adhd_framework_v3 --skill mcp-module-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This skill provides a standardized workflow for developing MCP modules within the ADHD Framework, enforcing the required structure, patterns, and templates to reduce ambiguity and accelerate delivery.

Core Features & Use Cases

  • Thin MCP server wrapper with tool-decorated functions limited to 10 lines each
  • Separate business logic into a dedicated MCP controller module, with a singleton getter
  • Docstring-driven schema for automatic MCP tool descriptions and input validation
  • Pyproject.toml templates and refresh scripts to register MCP servers in the workspace
  • Clear guidance on module scaffolding, testing, and deployment across layers

Quick Start

Follow the steps in this skill to scaffold a new MCP module using the provided template and best-practice patterns.

Frequently Asked Questions about mcp-module-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a new MCP server module?

Scaffold an MCP server module by generating the required <name>_mcp.py, <name>_controller.py, and refresh_full.py files. This workflow enforces structural and naming conventions to ensure correct tool invocation and schema generation.

What is the pattern for separating business logic in MCP module development?

MCP module development separates business logic into a dedicated controller module with a singleton getter. The thin MCP server wrapper contains only tool-decorated functions limited to 10 lines each.

How does docstring-driven schema generation work for MCP tools?

Docstring-driven schema generation uses Python docstrings to automatically create MCP tool descriptions and validate inputs. This eliminates manual schema definitions by deriving them directly from code documentation.

Do I need to manually register MCP servers in the workspace?

You do not need to manually register MCP servers. Pyproject.toml templates and refresh scripts handle registering MCP servers in the workspace during the build process.

What is lazy controller initialization in MCP modules?

Lazy controller initialization in MCP modules defers instantiating the business logic controller until it is actually requested via a singleton getter. This reduces startup overhead and resource consumption.

Why standardize MCP module structure for ADHD Framework development?

Standardizing MCP module structure for ADHD Framework development reduces ambiguity and accelerates delivery. It enforces required patterns and templates to ensure predictable module behavior across layers.