Architecture Pattern MCP
MCP server that provides architecture design expertise to AI coding agents
- 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.3Add 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).RequiredGENERATOR_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.RequiredEMBEDDER_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.