Design Pattern MCP Server

by olkio.github.olk/design-pattern-mcpv1.0.1

MCP server that provides design-pattern selection expertise to AI coding agents

0Dockerstdioofficial registry

context tax

pending

security

97/100

cold start

pending

freshness

Active2d ago

Our reading of Design Pattern, from the data

Design Pattern is a design MCP server from olk, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

Maintenance is active: the last public signal was 2 days ago (2026-10-17). For comparison, 70% of design servers are active or maintained.

With 0 GitHub stars it ranks #278 of 696 design servers we index.

It runs locally on your machine over stdio and needs 2 secrets (DESIGN_PATTERN_GENERATOR_API_KEY, DESIGN_PATTERN_EMBEDDER_API_KEY); use a scoped, least-privilege key.

Install Design Pattern MCP server

claude mcp add design-pattern -e DESIGN_PATTERN_GENERATOR_API_KEY='<design-pattern-generator-api-key>' -e DESIGN_PATTERN_EMBEDDER_BASE_URL='<design-pattern-embedder-base-url>' -e DESIGN_PATTERN_EMBEDDER_API_KEY=not-needed -e DESIGN_PATTERN_RERANKER_BASE_URL='<design-pattern-reranker-base-url>' -- docker run -i --rm -e DESIGN_PATTERN_GENERATOR_API_KEY -e DESIGN_PATTERN_EMBEDDER_BASE_URL -e DESIGN_PATTERN_EMBEDDER_API_KEY -e DESIGN_PATTERN_RERANKER_BASE_URL docker.io/olkowa/design-pattern-mcp:1.0.1 --transport stdio

{
  "mcpServers": {
    "design-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DESIGN_PATTERN_GENERATOR_API_KEY",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_API_KEY",
        "-e",
        "DESIGN_PATTERN_RERANKER_BASE_URL",
        "docker.io/olkowa/design-pattern-mcp:1.0.1",
        "--transport",
        "stdio"
      ],
      "env": {
        "DESIGN_PATTERN_GENERATOR_API_KEY": "<design-pattern-generator-api-key>",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL": "<design-pattern-embedder-base-url>",
        "DESIGN_PATTERN_EMBEDDER_API_KEY": "not-needed",
        "DESIGN_PATTERN_RERANKER_BASE_URL": "<design-pattern-reranker-base-url>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "design-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DESIGN_PATTERN_GENERATOR_API_KEY",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_API_KEY",
        "-e",
        "DESIGN_PATTERN_RERANKER_BASE_URL",
        "docker.io/olkowa/design-pattern-mcp:1.0.1",
        "--transport",
        "stdio"
      ],
      "env": {
        "DESIGN_PATTERN_GENERATOR_API_KEY": "<design-pattern-generator-api-key>",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL": "<design-pattern-embedder-base-url>",
        "DESIGN_PATTERN_EMBEDDER_API_KEY": "not-needed",
        "DESIGN_PATTERN_RERANKER_BASE_URL": "<design-pattern-reranker-base-url>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "design-pattern": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DESIGN_PATTERN_GENERATOR_API_KEY",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_API_KEY",
        "-e",
        "DESIGN_PATTERN_RERANKER_BASE_URL",
        "docker.io/olkowa/design-pattern-mcp:1.0.1",
        "--transport",
        "stdio"
      ],
      "env": {
        "DESIGN_PATTERN_GENERATOR_API_KEY": "<design-pattern-generator-api-key>",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL": "<design-pattern-embedder-base-url>",
        "DESIGN_PATTERN_EMBEDDER_API_KEY": "not-needed",
        "DESIGN_PATTERN_RERANKER_BASE_URL": "<design-pattern-reranker-base-url>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "design-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DESIGN_PATTERN_GENERATOR_API_KEY",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL",
        "-e",
        "DESIGN_PATTERN_EMBEDDER_API_KEY",
        "-e",
        "DESIGN_PATTERN_RERANKER_BASE_URL",
        "docker.io/olkowa/design-pattern-mcp:1.0.1",
        "--transport",
        "stdio"
      ],
      "env": {
        "DESIGN_PATTERN_GENERATOR_API_KEY": "<design-pattern-generator-api-key>",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL": "<design-pattern-embedder-base-url>",
        "DESIGN_PATTERN_EMBEDDER_API_KEY": "not-needed",
        "DESIGN_PATTERN_RERANKER_BASE_URL": "<design-pattern-reranker-base-url>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
DESIGN_PATTERN_GENERATOR_API_KEY	yes	yes	API key for the generator LLM (LiteLLM provider).
DESIGN_PATTERN_GENERATOR_PROVIDER	—	—	LiteLLM provider prefix, e.g. openai, anthropic, openrouter.
DESIGN_PATTERN_GENERATOR_MODEL	—	—	Model name, combined as <provider>/<model> via LiteLLM.
DESIGN_PATTERN_GENERATOR_BASE_URL	—	—	OpenAI-compatible base URL (LiteLLM api_base).
DESIGN_PATTERN_PATTERN_DIRECTORY	—	—	Directory with the catalog records (*.json main records plus per-language files). The image bakes the 438-record catalogue at /app/pattern.
DESIGN_PATTERN_EMBEDDER_BASE_URL	yes	—	Required: the dense retrieval leg embeds the 438-record catalogue during startup warmup and the server refuses to start when the endpoint is unreachable. TEI embeddings endpoint: on the Docker host use http://host.docker.internal:8080 (add --add-host=host.docker.internal:host-gateway on Linux); on a shared Docker network use http://design-pattern-tei-embed:8080.
DESIGN_PATTERN_EMBEDDER_API_KEY	—	yes	API key for the embedder. Keyless TEI accepts any non-empty value; use 'not-needed' there.
DESIGN_PATTERN_RERANKER_BASE_URL	yes	—	Required: retrieval runs a mandatory TEI cross-encoder rerank whenever the fused pool has more than one candidate. On the Docker host use http://host.docker.internal:8080; on a shared Docker network use http://design-pattern-tei-rerank:8080.

Security signals

97/100 — no known issues found as of 2026-10-19, from the checks below. This is not a guarantee of safety; review what a server can do before connecting it.

Deductions

No security policy (SECURITY.md)-3

Checks

✓Repository hygiene (archived, activity, license, security policy)
○Package metadata (install scripts, provenance) — pending
○Tool descriptions (prompt-injection and hidden-text heuristics) — pending
○Source scan (secrets, CVEs, risky code) by vectra-guard — pending

Scan it yourself before installing with vectra-guard, the open-source agent security CLI. Scoring rules

Freshness

Active — last maintenance signal 2d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-17 · 2d ago · GitHub
Latest release
2026-10-10 · 8d ago · GitHub · v1.0.1
Package published
no data · npm/PyPI
Registry entry updated
2026-10-10 · 8d ago · official registry · v1.0.1

How it compares in Design

Against the most-starred design servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
Design Pattern (this)	0	—	not measured	Active	local
Figma Developer	16,007	—	not measured	Slowing	local
Design System	11,774	—	not measured	Active	local
Magic	6,105	—	not measured	Maintained	—
Primer	3,918	—	not measured	Active	local
Dembrandt	3,722	—	not measured	Active	local

All design MCP servers

FAQ

›How do I install the Design Pattern MCP server in Claude Code?

Run: claude mcp add design-pattern -e DESIGN_PATTERN_GENERATOR_API_KEY='<design-pattern-generator-api-key>' -e DESIGN_PATTERN_EMBEDDER_BASE_URL='<design-pattern-embedder-base-url>' -e DESIGN_PATTERN_EMBEDDER_API_KEY=not-needed -e DESIGN_PATTERN_RERANKER_BASE_URL='<design-pattern-reranker-base-url>' -- docker run -i --rm -e DESIGN_PATTERN_GENERATOR_API_KEY -e DESIGN_PATTERN_EMBEDDER_BASE_URL -e DESIGN_PATTERN_EMBEDDER_API_KEY -e DESIGN_PATTERN_RERANKER_BASE_URL docker.io/olkowa/design-pattern-mcp:1.0.1 --transport stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Design Pattern require an API key?

Yes. It expects DESIGN_PATTERN_GENERATOR_API_KEY, DESIGN_PATTERN_EMBEDDER_BASE_URL, DESIGN_PATTERN_RERANKER_BASE_URL, DESIGN_PATTERN_EMBEDDER_API_KEY, of which 2 are secrets.

›Can I use Design Pattern as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Design Pattern in the official MCP registry?

Yes, as io.github.olk/design-pattern-mcp.

Sources and method

Official MCP Registry entry: updated 2026-10-10
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Security signals, computed by us: 2026-10-19
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.