MCP server that provides architecture design expertise to AI coding agents
npx @getmcp/cli add io.github.olk/architecture-pattern-mcpRequires Docker Engine. Community-contributed server. Review source before installing.
GENERATOR_API_KEYAPI key for the generator LLM (LiteLLM provider).
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.
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.
Config file: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"io.github.olk/architecture-pattern-mcp": {
"command": "docker",
"args": [
"host.docker.internal:host-gateway",
"run",
"-i",
"--rm",
"-e",
"GENERATOR_API_KEY",
"-e",
"GENERATOR_PROVIDER",
"-e",
"GENERATOR_MODEL",
"-e",
"GENERATOR_BASE_URL",
"-e",
"PATTERN_DIRECTORY",
"-e",
"EMBEDDER_PROVIDER",
"-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_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": "",
"EMBEDDER_API_KEY": "not-needed",
"RERANKER_BASE_URL": ""
}
}
}
}