mcp architect

Local 2025-08-31 23:23:48 0

Facilitates comprehensive architectural design and evaluation through specialized agents, rich resources, and powerful tools covering diverse architectural domains, including cloud, AI, and blockchain.


A Model Context Protocol server that provides comprehensive architectural expertise through specialized agents, resources, and tools.

Features

  • Suite of specialized architect agents covering various architectural domains:

  • Software Architecture

  • Cloud Architecture
  • AI Architecture
  • Microservices Architecture
  • Event-Driven Architecture
  • Serverless Architecture
  • Service Mesh Architecture
  • Multi-Cloud and Hybrid Cloud
  • Edge Computing
  • Data Mesh
  • Hexagonal Architecture
  • Blockchain-Based Architecture

  • Rich resources including:

  • Design templates

  • Best practices
  • Pattern catalogs
  • Case studies

  • Tools for:

  • Generating architectural designs
  • Evaluating architectures
  • Modifying architectural blueprints
  • Performing architectural analysis

Getting Started

  1. Install dependencies:
npm install
  1. Setup
# Copy environment file
cp .env.example .env

# Add your OpenAI API key
echo "OPENAI_API_KEY=your-key-here" >> .env

Project Structure

src/
├── agents/          # Specialized architect agents
├── resources/       # Architecture resources and templates
├── tools/          # Architecture tools and utilities
├── prompts/        # Agent prompts and instructions
└── server.ts       # MCP server implementation

Documentation

Examples

Check out our examples directory for:

  • Basic architecture generation
  • Custom evaluation criteria
  • Integration patterns
  • Migration strategies

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Security

Please report security vulnerabilities

License

This project is licensed under the ISC License - see the LICENSE.md file for details.

Acknowledgments

This project uses the Model Context Protocol SDK and OpenAI's GPT models. See NOTICE.md for details.

[
  {
    "description": "Perform a comprehensive analysis of a software architecture",
    "inputSchema": {
      "properties": {
        "constraints": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "description": {
          "type": "string"
        },
        "domain": {
          "type": "string"
        },
        "requirements": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "description",
        "requirements",
        "domain"
      ],
      "type": "object"
    },
    "name": "analyze_architecture"
  },
  {
    "description": "Generate a software architecture design based on requirements",
    "inputSchema": {
      "properties": {
        "domain": {
          "type": "string"
        },
        "requirements": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "style": {
          "enum": [
            "monolithic",
            "microservices",
            "layered",
            "event-driven",
            "serverless",
            "service-mesh",
            "multi-cloud",
            "hybrid-cloud",
            "edge-computing",
            "data-mesh",
            "ai-ml-centric",
            "hexagonal",
            "blockchain-based",
            "service-oriented-architecture",
            "reactive",
            "actor-based",
            "pipe-and-filter",
            "space-based"
          ],
          "type": "string"
        }
      },
      "required": [
        "requirements",
        "domain"
      ],
      "type": "object"
    },
    "name": "generate_architecture"
  },
  {
    "description": "Evaluate an architecture design against specific criteria",
    "inputSchema": {
      "properties": {
        "architecture": {
          "type": "object"
        },
        "criteria": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "domain": {
          "type": "string"
        }
      },
      "required": [
        "architecture",
        "criteria",
        "domain"
      ],
      "type": "object"
    },
    "name": "evaluate_architecture"
  }
]