npm install dieter-rams-mcp

pip install -r requirements.txt

npx dieter-rams-mcp

const { startMCPServer } = require('dieter-rams-mcp');
startMCPServer();

{
  "mcpServers": {
    "dieter-rams": {
      "command": "npx",
      "args": ["dieter-rams-mcp"]
    }
  }
}

{
  "description": "A minimalist smartphone with clean lines and intuitive interface",
  "category": "consumer electronics"
}

{
  "description": "Tesla Model S dashboard with single touchscreen",
  "principle": 4,
  "evidence": "All controls accessible through one interface"
}

{
  "description": "Overcomplicated smart home app with 50+ buttons",
  "current_issues": ["Too many options", "Confusing navigation"]
}

{
  "overall_score": 7.2,
  "principle_scores": {
    "1": { "score": 8, "feedback": "Innovative use of gesture controls" },
    "2": { "score": 9, "feedback": "Clearly serves user needs" },
    "3": { "score": 7, "feedback": "Clean aesthetic but could be refined" }
  },
  "summary": "Strong functional design with room for aesthetic improvement",
  "recommendations": ["Simplify color palette", "Reduce visual noise"]
}

{
  "principle": 4,
  "score": 6,
  "passes": false,
  "feedback": "Interface requires too much learning",
  "evidence_analysis": "Single touchscreen reduces physical complexity but cognitive load remains high",
  "suggestions": ["Add voice commands", "Implement gesture shortcuts"]
}

## The 10 Principles

1. Good design is innovative
2. Good design makes a product useful
3. Good design is aesthetic
4. Good design makes a product understandable
5. Good design is unobtrusive
6. Good design is honest
7. Good design is long-lasting
8. Good design is thorough down to the last detail
9. Good design is environmentally-friendly
10. Good design is as little design as possible

*"Less, but better" - Weniger, aber besser*

### Learn More About Dieter Rams
- [Wikipedia: Dieter Rams](https://en.wikipedia.org/wiki/Dieter_Rams)
- [Vitsoe: Dieter Rams Principles](https://www.vitsoe.com/us/about/good-design)
- [Book: Less and More - The Design Ethos of Dieter Rams](https://www.amazon.com/Less-More-Design-Ethos-Dieter/dp/3931936651)

## Troubleshooting

### Python Dependencies Not Found

Or try:

### Permission Errors on macOS/Linux

### Python Command Not Found
- Ensure Python 3.7+ is installed
- Try `python` instead of `python3`
- On Windows, ensure Python is in PATH

### MCP Server Won't Start
1. Check Node.js version: `node --version` (requires 16+)
2. Verify Python imports: `python3 -c "import fastmcp"`
3. Check file permissions on `server.py`

## License

ISC License - see package.json for details.

## Contributing

Issues and pull requests welcome. This is an open-source project for evaluating designs against timeless design principles.