KrakenD AI Assistant for Claude Code
Intelligent Claude Code plugin for KrakenD API Gateway with proactive Skills and Architecture Agent.
Overview
KrakenD AI Assistant is a powerful Claude Code plugin that brings intelligent KrakenD configuration assistance directly into your development workflow. It combines the universal KrakenD MCP Server with Claude Code-specific Skills and an Architecture Agent for an enhanced experience.
What Makes This Special?
- 🎯 Proactive Skills - Auto-activate based on your actions and questions
- 🏗️ Architecture Agent - Design multi-service API architectures
- 🤖 Automatic Binary Management - Downloads and manages MCP server automatically
- ✅ Zero Configuration - Works out of the box with SessionStart hook
- 🔄 Version Management - Automatic version checking and updates
Features
4 Proactive Skills
1. Config Validator
Auto-activates when you mention validation or have config issues.
You: "validate my krakend config"
Skill: Runs version-aware validation with specific error messages
2. Config Builder
Auto-activates when you want to create or modify configurations.
You: "create a new endpoint for user authentication"
Skill: Interactive config generation with best practices
3. Feature Explorer
Auto-activates when you ask about KrakenD features.
You: "what rate limiting options does krakend have?"
Skill: Shows features with CE/EE compatibility and examples
4. Security Auditor
Auto-activates when you mention security or audits.
You: "audit my config security"
Skill: Comprehensive security analysis with actionable fixes
1 Specialized Agent
Config Architect Agent
Spawns automatically for complex multi-service architectures.
You: "design an API gateway for microservices with auth, rate limiting, and caching"
Agent: Creates complete architecture with multiple endpoints, backends, and best practices
Installation
Via Claude Code
Install from the KrakenD marketplace or local development copy:
# From KrakenD marketplace (recommended)
/plugin marketplace add krakend/claude-code-plugin
/plugin install krakend-ai-assistant
# From local (development)
/plugin add ~/Code/krakend/claude-code-plugin
The plugin will automatically:
- Download the KrakenD MCP Server v0.8.0 (fully offline-capable with embedded docs)
- Verify checksums for security
- Install to the plugin directory
- Start the MCP server connection
Note: The MCP server binary includes embedded KrakenD documentation and search index (~21MB), making it fully functional offline. You can optionally update documentation using the refresh_documentation_index tool.
Manual Installation
If you want to install the MCP server manually:
# The plugin will handle this automatically, but you can also:
cd ~/Code/krakend/claude-code-plugin
./scripts/install-mcp.sh
Usage
Skills Auto-Activate
Just work naturally - skills activate automatically:
You: "I need to validate my krakend.json"
→ config-validator skill activates
You: "How do I add JWT validation?"
→ feature-explorer skill activates
You: "Check security of my config"
→ security-auditor skill activates
You: "Create an endpoint for /api/users"
→ config-builder skill activates
Agent for Complex Tasks
For architectural decisions:
You: "I need to design an API gateway for a microservices architecture with:
- User service (authentication)
- Product service (with caching)
- Order service (with rate limiting)
- All services need CORS and security headers"
→ config-architect agent spawns and designs complete architecture
How It Works
This plugin provides an enhanced KrakenD experience through:
- 4 Proactive Skills - Auto-activate when you need them
- 1 Architecture Agent - Designs complex multi-service setups
- KrakenD MCP Server - Automatically managed, provides validation, generation, and documentation tools
The plugin handles everything automatically - just install and start using it!
For Developers
Want to contribute or customize the plugin? See CONTRIBUTING.md for:
- Local development setup
- How to create/modify Skills
- How to create/modify Agents
- Testing guidelines
Troubleshooting
MCP Server Won't Start
# Check if binary exists
ls -la ~/.claude/plugins/krakend-ai-assistant/servers/krakend-mcp-server/
