AI Developer Guide API

JSON API providing standards, patterns and principles for effective AI-assisted development. This API is used by the MCP server to connect LLMs to the guide.

Quickstart

Add this JSON structure to your AI assistant (Claude Desktop, Cursor, VS Code, etc.):

{
  "mcpServers": {
    "ai-developer-guide": {
      "command": "npx",
      "args": ["@dwmkerr/ai-developer-guide-mcp"]
    }
  }
}

See the MCP documentation for detailed setup instructions (Claude, Cursor, VS Code, etc.) →

Example prompt: "Review my Python code and suggest improvements following best practices"

Test with MCP Inspector:
npx @modelcontextprotocol/inspector npx @dwmkerr/ai-developer-guide-mcp

About This API

This JSON API serves the AI Developer Guide content in a structured format that can be consumed by Large Language Models (LLMs) through the Model Context Protocol (MCP) server.

Core Features

Main Guide: Complete development methodology with Plan/Implement/Review approach
Language-Specific Guides: Best practices for Python, Shell Scripts, and more
Pattern Guides: Reusable patterns like Makefiles and project structure
Platform Guides: Database and infrastructure-specific recommendations

API Info

Base URL: Current domain
Format: JSON
Version: 0.1.20
Updated: 2025-10-29

Available Guides

Type	Guide	Endpoint
Main	AI Developer Guide	`api/guide.json`
Languages	Go	`api/guides/languages/go.json`
Languages	Python	`api/guides/languages/python.json`
Languages	Shell Scripts	`api/guides/languages/shell-scripts.json`
Patterns	CI/CD	`api/guides/patterns/cicd.json`
Patterns	CLIs (Command Line Applications)	`api/guides/patterns/clis.json`
Patterns	Documentation	`api/guides/patterns/documentation.json`
Patterns	MCP Servers	`api/guides/patterns/mcp-servers.json`
Patterns	Makefiles	`api/guides/patterns/make.json`
Patterns	Open Source	`api/guides/patterns/open-source.json`
Patterns	Pull Requests	`api/guides/patterns/pull-requests.json`
Platforms	PostgreSQL	`api/guides/platforms/postgresql.json`
Others	Configuration	`api/guides/others/configuration.json`
Others	Kubernetes Development	`api/guides/others/kubernetes-development.json`