Architecture Pattern MCP Server

by olkio.github.olk/architecture-pattern-mcpv1.1.3

MCP server that provides architecture design expertise to AI coding agents

1Dockerstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Architecture Pattern MCP server

claude mcp add architecture-pattern -e GENERATOR_API_KEY='<generator-api-key>' -e EMBEDDER_BASE_URL='<embedder-base-url>' -e EMBEDDER_API_KEY=not-needed -e RERANKER_BASE_URL='<reranker-base-url>' -- docker run -i --rm -e GENERATOR_API_KEY -e EMBEDDER_BASE_URL -e EMBEDDER_API_KEY -e RERANKER_BASE_URL docker.io/olkowa/architecture-pattern-mcp:1.1.3 --transport stdio

{
  "mcpServers": {
    "architecture-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GENERATOR_API_KEY",
        "-e",
        "EMBEDDER_BASE_URL",
        "-e",
        "EMBEDDER_API_KEY",
        "-e",
        "RERANKER_BASE_URL",
        "docker.io/olkowa/architecture-pattern-mcp:1.1.3",
        "--transport",
        "stdio"
      ],
      "env": {
        "GENERATOR_API_KEY": "<generator-api-key>",
        "EMBEDDER_BASE_URL": "<embedder-base-url>",
        "EMBEDDER_API_KEY": "not-needed",
        "RERANKER_BASE_URL": "<reranker-base-url>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "architecture-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GENERATOR_API_KEY",
        "-e",
        "EMBEDDER_BASE_URL",
        "-e",
        "EMBEDDER_API_KEY",
        "-e",
        "RERANKER_BASE_URL",
        "docker.io/olkowa/architecture-pattern-mcp:1.1.3",
        "--transport",
        "stdio"
      ],
      "env": {
        "GENERATOR_API_KEY": "<generator-api-key>",
        "EMBEDDER_BASE_URL": "<embedder-base-url>",
        "EMBEDDER_API_KEY": "not-needed",
        "RERANKER_BASE_URL": "<reranker-base-url>"
      }
    }
  }
}

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

{
  "servers": {
    "architecture-pattern": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GENERATOR_API_KEY",
        "-e",
        "EMBEDDER_BASE_URL",
        "-e",
        "EMBEDDER_API_KEY",
        "-e",
        "RERANKER_BASE_URL",
        "docker.io/olkowa/architecture-pattern-mcp:1.1.3",
        "--transport",
        "stdio"
      ],
      "env": {
        "GENERATOR_API_KEY": "<generator-api-key>",
        "EMBEDDER_BASE_URL": "<embedder-base-url>",
        "EMBEDDER_API_KEY": "not-needed",
        "RERANKER_BASE_URL": "<reranker-base-url>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "architecture-pattern": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GENERATOR_API_KEY",
        "-e",
        "EMBEDDER_BASE_URL",
        "-e",
        "EMBEDDER_API_KEY",
        "-e",
        "RERANKER_BASE_URL",
        "docker.io/olkowa/architecture-pattern-mcp:1.1.3",
        "--transport",
        "stdio"
      ],
      "env": {
        "GENERATOR_API_KEY": "<generator-api-key>",
        "EMBEDDER_BASE_URL": "<embedder-base-url>",
        "EMBEDDER_API_KEY": "not-needed",
        "RERANKER_BASE_URL": "<reranker-base-url>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
GENERATOR_API_KEY	yes	yes	API key for the generator LLM (LiteLLM provider).
GENERATOR_PROVIDER	—	—	LiteLLM provider prefix, e.g. openai, anthropic, openrouter, minimax.
GENERATOR_MODEL	—	—	Model name, combined as <provider>/<model> via LiteLLM.
GENERATOR_BASE_URL	—	—	OpenAI-compatible base URL (LiteLLM api_base).
PATTERN_DIRECTORY	—	—	Directory with *-pattern.json files. The image bakes the 40-pattern catalogue at /app/pattern.
EMBEDDER_PROVIDER	—	—	Embedding backend for pattern retrieval: tei, openai, ollama, vllm or hosted_vllm.
EMBEDDER_BASE_URL	yes	—	Required: 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_KEY	—	yes	API key for the embedder. Keyless TEI accepts any non-empty value; use 'not-needed' there.
RERANKER_BASE_URL	yes	—	Required: 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.

Freshness

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

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

FAQ

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

Run: claude mcp add architecture-pattern -e GENERATOR_API_KEY='<generator-api-key>' -e EMBEDDER_BASE_URL='<embedder-base-url>' -e EMBEDDER_API_KEY=not-needed -e RERANKER_BASE_URL='<reranker-base-url>' -- docker run -i --rm -e GENERATOR_API_KEY -e EMBEDDER_BASE_URL -e EMBEDDER_API_KEY -e RERANKER_BASE_URL docker.io/olkowa/architecture-pattern-mcp:1.1.3 --transport stdio. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Architecture Pattern require an API key?

Yes. It expects GENERATOR_API_KEY, EMBEDDER_BASE_URL, RERANKER_BASE_URL, EMBEDDER_API_KEY, of which 2 are secrets.

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

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

›Is Architecture Pattern in the official MCP registry?

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