Architecture Pattern MCP

io.github.olk/architecture-pattern-mcp

MCP server that provides architecture design expertise to AI coding agents

View repository →

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": {
    "architecture-pattern-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "docker.io/olkowa/architecture-pattern-mcp:1.1.3"
      ],
      "env": {
        "GENERATOR_API_KEY": "<your GENERATOR_API_KEY>",
        "GENERATOR_PROVIDER": "openai",
        "GENERATOR_MODEL": "gpt-4o-mini",
        "GENERATOR_BASE_URL": "https://api.openai.com/v1",
        "PATTERN_DIRECTORY": "/app/pattern",
        "EMBEDDER_PROVIDER": "tei",
        "EMBEDDER_BASE_URL": "<your EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<your EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<your RERANKER_BASE_URL>"
      }
    }
  }
}
Environment variables
  • GENERATOR_API_KEYrequiredsecretAPI key for the generator LLM (LiteLLM provider).
  • GENERATOR_PROVIDERLiteLLM provider prefix, e.g. openai, anthropic, openrouter, minimax.
  • GENERATOR_MODELModel name, combined as <provider>/<model> via LiteLLM.
  • GENERATOR_BASE_URLOpenAI-compatible base URL (LiteLLM api_base).
  • PATTERN_DIRECTORYDirectory with *-pattern.json files. The image bakes the 40-pattern catalogue at /app/pattern.
  • EMBEDDER_PROVIDEREmbedding backend for pattern retrieval: tei, openai, ollama, vllm or hosted_vllm.
  • EMBEDDER_BASE_URLrequiredRequired: the dense retrieval leg embeds the 40-pattern catalogue during startup warmup and the server refuses to start when the endpoint is unreachable. OpenAI-compatible embeddings endpoint ending in /v1: on the Docker host use http://host.docker.internal:8080/v1 (add --add-host=host.docker.internal:host-gateway on Linux); on a shared Docker network use http://pattern-tei-embed:8080/v1.
  • EMBEDDER_API_KEYsecretAPI key for the embedder. Keyless TEI accepts any non-empty value; use 'not-needed' there.
  • RERANKER_BASE_URLrequiredRequired: pattern retrieval runs a mandatory TEI cross-encoder rerank. On the Docker host use http://host.docker.internal:8080; on a shared Docker network use http://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.1.5
Registry
active
Published
10/9/2026

More Developer Tools servers

Browse all Developer Tools →

Design Pattern MCP

olk

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

Developer ToolsAdded 1 month ago

Consistency Calendar

olliejgooding

Turn any goal with a deadline into a private, gamified, evidence-based execution calendar.

Developer ToolsAdded 3 months ago

Ball Ranks Fantasy Sports

Ollynov

Fantasy football and basketball rankings and player projections from Ball Ranks.

Developer ToolsAdded 3 weeks ago

CalKit

OlsOls4

Public holidays for 150+ countries, business-day maths and timezone lookup

Developer ToolsAdded 3 weeks ago

CurrencyKit

OlsOls4

ECB euro reference exchange rates: latest, historical, time series and currency conversion

Developer ToolsAdded 3 weeks ago

DocKit

OlsOls4

Extract text and metadata from PDFs; convert Markdown or text to PDF

Developer ToolsAdded 3 weeks ago

Add the badge to your site

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

Architecture Pattern MCP — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-olk-architecture-pattern-mcp?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Architecture 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

[![Architecture Pattern MCP — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-olk-architecture-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.