Includes deployment patterns for containerization and service orchestration using Docker Compose.
Offers patterns for integrating GitHub features and managing codebase patterns through GitHub repositories.
Provides automated CI/CD workflow patterns for deploying applications via GitHub Actions.
Provides implementation patterns for Google OAuth authentication.
Provides implementation patterns for passwordless authentication using Magic Links.
Includes patterns for implementing caching and rate limiting using Redis.
Provides production-ready implementation patterns for Stripe Checkout, webhooks, and the customer portal.
Offers patterns for Supabase authentication (OAuth, Magic Links), database management, and Row-Level Security (RLS) policies.
Provides patterns for implementing API rate limiting and serverless data storage using Upstash.
Provides deployment patterns for hosting applications on the Vercel platform.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nyko MCP ServerShow me the pattern for Google OAuth with Supabase"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nyko MCP Server
MCP (Model Context Protocol) server that provides battle-tested implementation patterns to AI coding assistants like Claude Code, Cursor, and Windsurf.
What is Nyko?
Nyko provides production-ready code patterns for common features:
Auth: Supabase OAuth (Google, GitHub), Magic Links, Protected Routes
Payments: Stripe Checkout, Webhooks, Customer Portal
Database: RLS Policies, Migrations
Deploy: Docker Compose, GitHub Actions + Vercel
API: Rate Limiting with Upstash
Usage
With Claude Code
Add to ~/.claude/settings.json:
{
"mcpServers": {
"nyko": {
"url": "https://nyko-mcp.nyko-ai.workers.dev/mcp"
}
}
}Then ask Claude:
"Set up Google OAuth with Supabase"
"Add Stripe payments to my app"
"Create protected routes"
Available Tools
Tool | Description |
| Search for patterns by keyword |
| Get complete pattern with code, env vars, and setup steps |
| Get ordered list of patterns for a complete feature |
| Check if a pattern is compatible with your project |
Development
Prerequisites
Node.js 18+
Wrangler CLI (
npm install -g wrangler)
Setup
# Clone the repo
git clone https://github.com/nyko-ai/mcp.git
cd mcp
# Install dependencies
npm install
# Copy env vars example
cp .dev.vars.example .dev.vars
# Edit .dev.vars with your Upstash credentials (optional for local dev)
# Start dev server
npm run devTesting
# Test initialize
curl -X POST http://localhost:8787/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}'
# Test tools/list
curl -X POST http://localhost:8787/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
# Test nyko_search
curl -X POST http://localhost:8787/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"nyko_search","arguments":{"query":"google oauth"}}}'Deploy
# Login to Cloudflare
wrangler login
# Set secrets
wrangler secret put UPSTASH_REDIS_REST_URL
wrangler secret put UPSTASH_REDIS_REST_TOKEN
# Deploy
npm run deployArchitecture
┌─────────────────────────────────────────────────────────┐
│ MCP Client (Claude Code, Cursor) │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Cloudflare Worker (MCP Server) │ │
│ │ │ │
│ │ /mcp (POST) - MCP protocol endpoint │ │
│ │ /sse (GET) - Server-sent events (future) │ │
│ │ /health - Health check │ │
│ └─────────────────────────────────────────────────┘ │
│ │ │
│ ┌──────────────┼──────────────┐ │
│ ▼ ▼ ▼ │
│ ┌───────────┐ ┌───────────┐ ┌───────────┐ │
│ │ Upstash │ │ GitHub │ │ (Future) │ │
│ │ Redis │ │ Raw │ │ Supabase │ │
│ │ (cache) │ │ (patterns)│ │ DB │ │
│ └───────────┘ └───────────┘ └───────────┘ │
└─────────────────────────────────────────────────────────┘API Reference
Endpoints
Endpoint | Method | Description |
| POST | Main MCP protocol endpoint (JSON-RPC 2.0) |
| GET | Health check |
Tools Reference
nyko_search
Search for patterns by keyword.
Input:
{
"query": "google oauth",
"category": "auth" // optional: auth, payments, database, deploy, api
}Output:
{
"patterns": [
{
"id": "supabase-google-oauth",
"name": "Google OAuth with Supabase",
"description": "Complete Google OAuth implementation",
"difficulty": "intermediate",
"time_estimate": "20-30 min",
"status": "beta"
}
],
"total": 1
}nyko_get
Get complete implementation details for a pattern.
Input:
{
"pattern_id": "supabase-google-oauth",
"has_src_dir": false // optional: adjust paths for src/ directory
}Output:
{
"pattern": {
"id": "supabase-google-oauth",
"name": "Google OAuth with Supabase",
"install": "npm install @supabase/supabase-js@^2.49.0 @supabase/ssr@^0.5.2",
"env": [{"key": "NEXT_PUBLIC_SUPABASE_URL", "required": true}],
"files": [{"path": "lib/supabase/client.ts", "code": "..."}],
"external_setup": [{"provider": "supabase", "steps": [...]}],
"edge_cases": [{"symptom": "...", "solution": "..."}],
"validation": ["Navigate to /login", "Click Google sign in"]
}
}nyko_sequence
Get ordered sequence of patterns for a complete feature.
Input:
{
"goal": "google auth with protected routes",
"already_implemented": [] // optional: skip patterns already done
}Output:
{
"sequence": [
{"order": 1, "id": "supabase-client-nextjs", "reason": "Base setup"},
{"order": 2, "id": "supabase-google-oauth", "reason": "Authentication"},
{"order": 3, "id": "supabase-protected-routes", "reason": "Route protection"}
],
"total_time": "30-45 min"
}nyko_check
Check pattern compatibility with project dependencies.
Input:
{
"pattern_id": "supabase-google-oauth",
"dependencies": {"next": "15.1.0", "@supabase/supabase-js": "2.49.0"}
}Output:
{
"compatible": true,
"issues": [],
"missing": ["@supabase/ssr"],
"install_command": "npm install @supabase/ssr@^0.5.2"
}Environment Variables
# Required for caching (optional for local dev)
UPSTASH_REDIS_REST_URL=https://xxx.upstash.io
UPSTASH_REDIS_REST_TOKEN=xxxContributing
Patterns are stored in the nyko-ai/patterns repository. See the contributing guide there for adding new patterns.
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.