Design Pattern MCP

io.github.olk/design-pattern-mcp

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

Connect this server

Add this to your MCP client config — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor).Suits: Claude Desktop · Cursor.

{
  "mcpServers": {
    "design-pattern-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/olkowa/design-pattern-mcp:1.0.1"
      ],
      "env": {
        "DESIGN_PATTERN_GENERATOR_API_KEY": "<your DESIGN_PATTERN_GENERATOR_API_KEY>",
        "DESIGN_PATTERN_GENERATOR_PROVIDER": "openai",
        "DESIGN_PATTERN_GENERATOR_MODEL": "gpt-4o-mini",
        "DESIGN_PATTERN_GENERATOR_BASE_URL": "https://api.openai.com/v1",
        "DESIGN_PATTERN_PATTERN_DIRECTORY": "/app/pattern",
        "DESIGN_PATTERN_EMBEDDER_BASE_URL": "<your DESIGN_PATTERN_EMBEDDER_BASE_URL>",
        "DESIGN_PATTERN_EMBEDDER_API_KEY": "<your DESIGN_PATTERN_EMBEDDER_API_KEY>",
        "DESIGN_PATTERN_RERANKER_BASE_URL": "<your DESIGN_PATTERN_RERANKER_BASE_URL>"
      }
    }
  }
}
Environment variables
  • DESIGN_PATTERN_GENERATOR_API_KEYrequiredsecretAPI key for the generator LLM (LiteLLM provider).
  • DESIGN_PATTERN_GENERATOR_PROVIDERLiteLLM provider prefix, e.g. openai, anthropic, openrouter.
  • DESIGN_PATTERN_GENERATOR_MODELModel name, combined as <provider>/<model> via LiteLLM.
  • DESIGN_PATTERN_GENERATOR_BASE_URLOpenAI-compatible base URL (LiteLLM api_base).
  • DESIGN_PATTERN_PATTERN_DIRECTORYDirectory 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_URLrequiredRequired: 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_KEYsecretAPI key for the embedder. Keyless TEI accepts any non-empty value; use 'not-needed' there.
  • DESIGN_PATTERN_RERANKER_BASE_URLrequiredRequired: 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.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
1.0.1
Registry
active
Published
10/10/2026
Browse all Developer Tools →

Add the badge to your site

Show visitors that Design Pattern MCP is listed here — it’s also the link we check for a free listing.

Design Pattern MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-olk-design-pattern-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Design Pattern MCP — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![Design Pattern MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-olk-design-pattern-mcp?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.