MCP server providing Clean Code, Clean Architecture, and GoF design pattern knowledge for agents
1.7K
An MCP (Model Context Protocol) server that gives your AI coding assistant access to 31 software engineering books worth of knowledge, including Clean Code, Clean Architecture, Gang of Four Design Patterns, and more.
This Docker image runs an MCP server that enhances AI coding assistants with:
docker run -i --rm luminogarrett/software-design-mcp:latest
Add to your Claude Desktop config file:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"software-design": {
"command": "docker",
"args": ["run", "-i", "--rm", "luminogarrett/software-design-mcp:latest"]
}
}
}
Restart Claude Desktop, then ask: "Use discover_knowledge_bases to show available knowledge"
If using Docker MCP Gateway:
# Register and enable
docker mcp catalog add https://raw.githubusercontent.com/gpears98/mcps/main/software-design-mcp/custom-mcp.yaml
docker mcp server enable software-design-mcp
docker mcp client connect vscode
| Tool | What it does |
|---|---|
discover_knowledge_bases | List all 31 books or get details about one |
list_knowledge_items | Browse items by type, book, or category |
get_knowledge_item | Get complete details for any item |
search_knowledge | Search across all knowledge by keyword |
| Tool | What it does |
|---|---|
diagnose_code_symptoms | Describe problems, get matching principles |
find_pattern | Describe a problem, find design patterns that solve it |
suggest_for_context | Describe your task, get relevant principles |
get_examples | Get code examples for any concept |
| Tool | What it does |
|---|---|
validate_against_principle | Get checklist to verify code quality |
get_checklist | Get checklists for code review, refactoring, etc. |
get_antipattern_for_principle | Learn what NOT to do |
| Tool | What it does |
|---|---|
get_principle_journey | Get structured learning paths |
get_principle_conflicts | Navigate trade-offs between principles |
get_related_items | Explore connected concepts |
compare_knowledge_items | Compare patterns side-by-side |
Find a design pattern:
"I need to create different types of reports but don't want to hardcode which type. Use find_pattern to help."
Diagnose code problems:
"Use diagnose_code_symptoms with these issues: god class, methods with 10+ parameters, deeply nested conditionals"
Get a code review checklist:
"Use get_checklist for code_review to help me review this PR"
Learn SOLID principles:
"Use get_principle_journey with solid_fundamentals to create a learning plan"
| Issue | Solution |
|---|---|
| Container exits immediately | Use -i flag: docker run -i --rm ... |
| Claude doesn't see tools | Restart Claude Desktop after config change |
| "Connection refused" | Ensure Docker is running |
| Tools not responding | Try pulling latest: docker pull luminogarrett/software-design-mcp:latest |
latest - Most recent stable releasetest - Development/testing versionMIT License
Content type
Image
Digest
sha256:ab36bb048…
Size
66.5 MB
Last updated
9 months ago
docker pull luminogarrett/software-design-mcp