Built on Python 3.10+ with MCP SDK, providing file-based template storage and async I/O for documentation generation
docs-mcp
Version: 1.0.0 Date: 2025-10-08 Maintainer: willh
Overview
docs-mcp is a Model Context Protocol (MCP) server that provides AI assistants with structured documentation generation capabilities. It offers access to professional documentation templates based on the POWER framework (Purpose, Output, Work, Examples, Requirements) and prompt engineering frameworks.
This server enables AI assistants to:
Access standardized documentation templates for README, Architecture, API, Components, and Schema docs
Retrieve prompt framework documentation (POWER, COSTAR, Five S, CRISPE)
Generate consistent, professional documentation across projects
Prerequisites
Python 3.10 or higher
MCP-compatible AI client (Claude Desktop, Claude Code CLI, etc.)
pip package manager
Installation
Quick Install
Manual Installation
Clone or download the docs-mcp server to your MCP servers directory:
cd C:\Users\willh\.mcp-serversEnsure the server structure includes:
docs-mcp/ ├── server.py ├── templates/ │ └── power/ │ ├── readme.txt │ ├── architecture.txt │ ├── api.txt │ ├── components.txt │ └── schema.txt └── frameworks/ └── [framework documentation files]Add to your MCP configuration (
claude_desktop_config.json
or similar):{ "mcpServers": { "docs-mcp": { "command": "python", "args": ["C:\Users\willh\.mcp-servers\docs-mcp\server.py"] } } }
Available Tools
1. list_templates
Lists all available POWER framework documentation templates.
Usage:
Returns:
readme
architecture
api
components
schema
2. get_template
Retrieves the full content of a specific documentation template.
Usage:
Parameters:
template_name
(required): One of:readme
,architecture
,api
,components
,schema
Returns: The complete template content with POWER framework structure
3. list_frameworks
Lists available prompt framework documentation files.
Usage:
Returns: List of framework documentation files with sizes
Template Structure
All templates follow the POWER Framework:
Purpose: Define the document's objective
Output: Specify required format and structure
Work: Outline the process and what to analyze
Examples: Provide concrete samples
Requirements: List mandatory elements
Each template includes:
framework
: POWERpurpose
: Document objectiveoutput
: Required format with headers/footerswork
: Analysis steps (scan, analyze, document)examples
: Practical usage samplesrequirements
: Must-have elementssave_as
: Default filenamestore_as
: Storage reference name
Usage Examples
Example 1: Generate a README
Example 2: Architecture Documentation
Example 3: API Documentation
Troubleshooting
Issue: Templates not found
Error: No templates found in templates/power/
Resolution:
Verify templates directory exists:
C:\Users\willh\.mcp-servers\docs-mcp\templates\power\
Ensure .txt template files are present (readme.txt, architecture.txt, etc.)
Check file permissions - templates must be readable
Issue: Server not responding
Error: MCP connection timeout or server unresponsive
Resolution:
Verify Python 3.10+ is installed:
python --version
Check server.py path in MCP configuration
Test server manually:
python C:\Users\willh\.mcp-servers\docs-mcp\server.py
Review MCP server logs for detailed error messages
Issue: Invalid template name
Error: Template 'xyz' not found
Resolution:
Use only valid template names:
readme
,architecture
,api
,components
,schema
Template names are case-sensitive (use lowercase)
Use
list_templates()
to see available options
Project Structure
Development
Adding New Templates
Create a new
.txt
file intemplates/power/
Follow POWER framework structure:
framework: POWER purpose: [Define purpose] output: [Specify format] work: [Outline process] examples: [Provide samples] requirements: [List must-haves] save_as: [filename] store_as: [reference name]Add enum value to server.py line 46
Restart MCP server
Server Architecture
Built on MCP SDK for Python
Async I/O using asyncio
Stdio transport for client communication
File-based template storage
Zero external dependencies beyond MCP SDK
License
[Specify license here]
AI Integration Footer
This MCP server is optimized for AI assistant integration. It provides structured templates that guide documentation generation with consistent quality and format. Templates include decision trees for content selection and command sequences for implementation.
For AI assistants: Use the POWER framework templates to ensure comprehensive, well-structured documentation. Follow the work
section for systematic analysis and the requirements
section for mandatory elements.
🤖 This README was generated using the docs-mcp POWER framework template
Support: For issues or questions, consult the troubleshooting section above or review MCP server logs.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables AI assistants to generate professional documentation using structured templates based on the POWER framework. Provides access to standardized templates for README, architecture, API, components, and schema documentation.