Design Patterns MCP Server

MCP服务器设计模式

](https://github.com/apolosan/design_patterns_mcp)    

智能MCP（模型上下文协议）服务器，使用混合搜索（语义+关键字+图增强）提供设计模式建议。访问 705+设计图案 通过具有高级混合RAG架构的自然语言界面，跨90多个类别。

快速开始

# Clone and setup
git clone https://github.com/apolosan/design_patterns_mcp.git
cd design_patterns_mcp

# Install dependencies and build (using bun)
bun install
bun run db:setup

# Or using npm (if bun is not installed)
npm install --ignore-scripts
npx tsc
node dist/src/cli/migrate.js
node dist/src/cli/seed.js
node dist/src/cli/generate-embeddings.js
node dist/src/cli/setup-relationships.js

在MCP客户端（Claude Desktop、Cursor等）中进行配置，并开始通过自然语言查询发现模式。

工具和建筑卫生

• 使用 包子 作为此存储库的规范包管理器(bun install 仅）。锁文件是 bun.lock.
• 从不复制 .git 目录进入 dist/data （或把它运进去 dist/).该路径必须保持为纯数据目录，以避免数GB的图像和元数据泄漏。

特性

可用图案类别

建筑

src/
├── adapters/              # External service adapters (LLM, embeddings)
├── cli/                   # CLI commands (migrate, seed, embeddings, setup-relationships)
├── core/                  # DI Container, configuration builder
├── db/                    # Database migrations
├── events/                # Event bus system
├── handlers/              # MCP request handlers (hybrid search, recommendations)
├── health/                # Health check services
├── repositories/          # Data access layer
├── search/                # Hybrid search engine
├── services/              # Business services (cache, telemetry, pattern service)
├── strategies/            # Strategy pattern implementations
├── types/                 # TypeScript type definitions
└── mcp-server.ts          # MCP server entry point

data/
├── patterns/              # 705+ JSON pattern definitions (see `feature-flag.json`)
└── design-patterns.db     # SQLite database with embeddings

用法

发现模式

通过您的MCP客户提出自然语言问题：

"I need to create complex objects with many optional configurations"
→ Builder, Abstract Factory, Factory Method

"How to handle service failures gracefully in distributed systems?"
→ Circuit Breaker, Bulkhead, Retry, Fallback

"What pattern helps with state-dependent behavior in React?"
→ State Machine, Observer, useReducer

"How to implement secure authentication and authorization?"
→ OAuth 2.0, RBAC, JWT, Zero Trust

MCP工具

安装

先决条件

• Node.js>=18.0.0
• Bun>=1.0.0（推荐）或npm>=8.0.0

使用Bun进行设置

bun install
bun run build
bun run db:setup

使用npm进行设置

这 prepare 脚本在 package.json 需要 bun如果你没有 bun 安装、使用 --ignore-scripts 跳过它并手动构建：

npm install --ignore-scripts
npx tsc

# Setup database
node dist/src/cli/migrate.js
node dist/src/cli/seed.js
node dist/src/cli/generate-embeddings.js
node dist/src/cli/setup-relationships.js

MCP配置

添加到您的MCP客户端配置（Claude Desktop、Cursor等）：

{
  "mcpServers": {
    "design-patterns": {
      "command": "node",
      "args": ["/absolute/path/to/design-patterns-mcp/dist/src/mcp-server.js"],
      "env": {
        "LOG_LEVEL": "info",
        "DATABASE_PATH": "/absolute/path/to/design-patterns-mcp/data/design-patterns.db",
        "ENABLE_HYBRID_SEARCH": "true",
        "ENABLE_GRAPH_AUGMENTATION": "true",
        "EMBEDDING_COMPRESSION": "true",
        "ENABLE_FUZZY_LOGIC": "true",
        "ENABLE_TELEMETRY": "true",
        "ENABLE_MULTI_LEVEL_CACHE": "true"
      }
    }
  }
}

重要提示： 对两者都使用绝对路径 args 和 DATABASE_PATH.MCP客户端（如Cursor）不可靠地支持 cwd 字段，因此相对路径针对用户的主目录而不是项目目录进行解析。看 QUICKSTART.md 用于客户端特定的配置示例。

环境变量

Docker 部署

快速开始

# Build
docker build -t design-patterns-mcp .

# Run HTTP mode
docker run -p 3000:3000 -e TRANSPORT_MODE=http design-patterns-mcp

# Run stdio mode (default)
docker run design-patterns-mcp

Docker Compose

docker compose up --build -d

环境变量

端点（HTTP模式）

• GET /health -健康检查
• POST /mcp -MCP JSON-RPC端点

命令

# Development
bun run build        # Compile TypeScript
bun run dev          # Development with hot reload
bun run start        # Build and start production server

# Database
bun run db:setup     # Complete database setup
bun run migrate      # Run migrations
bun run seed         # Seed pattern data
bun run generate-embeddings  # Generate semantic embeddings
bun run setup-relationships  # Setup pattern relationships

# Quality
bun run test         # Run all tests
bun run lint         # Check code quality
bun run lint:fix     # Auto-fix linting issues
bun run typecheck    # TypeScript type checking

测试

该项目包括 44个测试文件中的525个测试用例 通过率100%：

• 合同测试：MCP协议合规性验证
• 集成测试：组件交互测试
• 性能测试：搜索和矢量化基准
• 单元测试：单个组件测试

# Run all tests
bun run test

# Run specific test suites
bun run test:unit -- --grep "PatternService"
bun run test:integration -- --grep "database"
bun run test:performance -- --timeout 30000

架构模式

此项目实现了它所记录的模式：

贡献

欢迎投稿！请在提交PR之前阅读我们的投稿指南。

1. 分叉存储库
2. 创建要素分支
3. 根据SOLID原则进行更改
4. 运行测试和梳理
5. 提交拉取请求

许可证

MIT许可证-请参阅 许可证 了解详情。

资源

• 模型上下文协议
• sqlite-vc
• 设计模式目录

______________________________________________________________________

版本: 0.5.1\ 最后更新2026年5月\ 模式：705+JSON定义（突出显示： 功能开关 /功能切换）\ 测试：525个测试用例| 100%通过率