Skip to content
MCP server

Architecture Pattern MCP

MCP server that provides architecture design expertise to AI coding agents

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.1.5
Listing updated
5 days ago

About Architecture Pattern MCP

Architecture Pattern MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add architecture-pattern-mcp --env GENERATOR_API_KEY='<GENERATOR_API_KEY>' --env EMBEDDER_BASE_URL='<EMBEDDER_BASE_URL>' --env EMBEDDER_API_KEY='<EMBEDDER_API_KEY>' --env 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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "architecture-pattern-mcp": {
      "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"
      ],
      "env": {
        "GENERATOR_API_KEY": "<GENERATOR_API_KEY>",
        "EMBEDDER_BASE_URL": "<EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<RERANKER_BASE_URL>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "architecture-pattern-mcp": {
      "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"
      ],
      "env": {
        "GENERATOR_API_KEY": "<GENERATOR_API_KEY>",
        "EMBEDDER_BASE_URL": "<EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<RERANKER_BASE_URL>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "architecture-pattern-mcp": {
      "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"
      ],
      "env": {
        "GENERATOR_API_KEY": "<GENERATOR_API_KEY>",
        "EMBEDDER_BASE_URL": "<EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<RERANKER_BASE_URL>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "architecture-pattern-mcp": {
      "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"
      ],
      "env": {
        "GENERATOR_API_KEY": "<GENERATOR_API_KEY>",
        "EMBEDDER_BASE_URL": "<EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<RERANKER_BASE_URL>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "architecture-pattern-mcp": {
      "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"
      ],
      "env": {
        "GENERATOR_API_KEY": "<GENERATOR_API_KEY>",
        "EMBEDDER_BASE_URL": "<EMBEDDER_BASE_URL>",
        "EMBEDDER_API_KEY": "<EMBEDDER_API_KEY>",
        "RERANKER_BASE_URL": "<RERANKER_BASE_URL>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GENERATOR_API_KEYAPI key for the generator LLM (LiteLLM provider).Required
  • 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_URLRequired: 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.Required
  • EMBEDDER_API_KEYAPI key for the embedder. Keyless TEI accepts any non-empty value; use 'not-needed' there.
  • RERANKER_BASE_URLRequired: 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.Required

Pricing

Open source

Architecture Pattern MCP FAQ

Is Architecture Pattern MCP free?

Yes. Architecture Pattern MCP is open source, so you can use and self-host it for free.

How do I add Architecture Pattern MCP to Claude Code?

Run this command in your terminal: claude mcp add architecture-pattern-mcp --env GENERATOR_API_KEY='<GENERATOR_API_KEY>' --env EMBEDDER_BASE_URL='<EMBEDDER_BASE_URL>' --env EMBEDDER_API_KEY='<EMBEDDER_API_KEY>' --env 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

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers