Moretes Architect MCP

Claude Code · Codex · Kiro · Cursor · VS Code · Gemini CLI · Amazon Q · Claude Desktop
接続 · 動作を見る · ツール · パイプライン · プライバシー · チュートリアルとコース · English

48 個の決定論的なアーキテクチャツールと10 種類のアーキテクトのペルソナをコーディングエージェント内で利用できるようにする MCP サーバーです。クライアントのモデルが推論し、サーバーは計算結果、構成、公式情報源、明示的な不足情報を返します。サーバーがモデルを呼び出すことは一切なく、インターネット経由でお客様のアカウントにアクセスすることも、API キーを必要とすることもありません。

情報技術スペシャリストアーキテクトであり、AWS Community Builder（AI Engineering）でもある Fernando Azevedo が開発しました。日々のアーキテクチャ判断に私自身が使っているものを、コミュニティが利用、監査、拡張できるよう公開しています。

動作をご覧ください

API を求めると、提案する前に質問します。 エージェントは requirements_check を呼び出してから architect_panel を実行します。数字をでっち上げることはありません。

当てずっぽうではなく、計算します。 Kiro では、latency_budget が直列ステップを合計し、並列ステップの最大値を取り、時間の内訳を表示します。

パイプラインで危険な apply をブロックします。 同じエンジンを CLI としてオフラインで実行でき、Markdown、JSON、SARIF に対応し、重大度に応じた終了コードを返します。

GIF は無料コースの動画から抜粋したもので、私の声で解説しています。サーバーの実際の呼び出しと応答を収録しています。完全な JSON は docs/examples にあります。

30 秒で接続

API キーも登録も不要です。

# Claude Code
claude mcp add --transport http moretes-architect https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp

# Codex
codex mcp add moretes-architect --url https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp

# Gemini CLI
gemini mcp add --transport http moretes-architect https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp

{
  "mcpServers": {
    "moretes-architect": {
      "url": "https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp",
      "autoApprove": []
    }
  }
}

{
  "servers": {
    "moretes-architect": { "type": "http", "url": "https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp" }
  }
}

{ "mcpServers": { "moretes-architect": { "command": "node", "args": ["/CAMINHO/ABSOLUTO/dist/stdio.js"] } } }

公開枠はクライアントあたり 1 日 300 リクエスト、合計 3,000 リクエストです。上限を超えると 429 が返されます。同じサーバーは https://fernando.moretes.com/api/mcp でも応答しますが、このアドレスはサイトを経由し、すべてのユーザーで 1 日の枠を共有します。自分専用の枠を使うには、直接 URL を使用してください。大量の利用や非公開の入力には、ローカルで実行してください。

接続後、エージェントに次のように依頼してください。

「Moretes Architect を使ってください。マーケットプレイス向けに、ピーク時で毎分 300 件の注文を処理する API が必要です。提案する前に不足している情報を質問し、ソリューションアーキテクト、セキュリティアーキテクト、FinOps の担当者を招集してください。Lambda と ECS を比較し、C4 図を作成して、決定内容を ADR に記録してください。」

できること

iam_policy_review は、AWS IAM ポリシー、Azure のロール定義、Google Cloud のバインディングを読み込みます（provider）。すべての計算・レビュー用ツールは outputSchema を公開し、クライアントが出力を検証します。

さらに、20 個のプロンプト（10 個のワークフローと、各ペルソナ用の architect_<papel>）、18 個のリソース（moretes://guide、moretes://boundaries、moretes://tools、moretes://personas/<id>、moretes://skills/<id>）、およびローカルモードのみで使える、AWS アカウントと公式サーバーとのフェデレーション用の任意の5つのツールがあります。

各ツールのガイド：docs/tools-guide.md · スキーマ：docs/tools.md · 実際の出力：docs/examples · ペルソナ：docs/personas.md

実際の出力：c4_model が描画した C4

入力：人、システム、明示的な関係。出力：検証済みの Mermaid（重複 ID、孤立したエッジ、危険な構文を含むラベルは拒否されます）。GitHub では、docs/examples/c4_model.json でツールが返したものとまったく同じ内容が、以下にレンダリングされます。

flowchart TB
  buyer(["Buyer<br/>Places and tracks orders"])
  subgraph system_Orders_platform["Orders platform"]
    web["Storefront [Next.js]"]
    api["Orders API [Node.js on Fargate]"]
    db["Orders DB [PostgreSQL]"]
    bus["Order events [EventBridge]"]
  end
  psp[["Payment provider [REST + webhooks]"]]
  buyer -->|"uses"| web
  web -->|"calls (HTTPS/JSON)"| api
  api -->|"reads and writes"| db
  api -->|"authorizes payment"| psp
  psp -->|"webhook: payment captured"| api
  api -->|"publishes OrderPlaced"| bus
  classDef person fill:#1f3b63,stroke:#5b9bd5,color:#fff
  class buyer person
  classDef external fill:#4a4a4a,stroke:#9a9a9a,color:#fff
  class psp external

実際の出力：不正な MCP サーバーのレビュー

mcp_server_review は、別のサーバーの tools/list を受け取り、説明文に隠された指示文、危険なパラメーター、虚偽のアノテーション、重複した名前を検出します。docs/examples/mcp_server_review.json のサンプルサーバーを対象にした結果：

{
  "summary": { "high": 5, "medium": 1, "info": 0 },
  "verdict": "Do not auto-approve; review each high finding with the server author or pin to an allowlist",
  "findings": [
    { "severity": "high", "target": "read_file", "message": "Description contains instruction-like text (references local secret files); tool-poisoning indicator." },
    { "severity": "high", "target": "read_file", "message": "Parameters that typically carry commands, raw queries, URLs or paths: path. Require an allowlist and per-call approval." }
  ]
}

存在する理由

クラウドの MCP サーバーは運用向けで、アカウント内で実行されます。その前段階、つまり要件の洗い出し、プロバイダー間の誠実な比較、当て推量ではなく計算による見積もり、根拠に基づくレビュー、意思決定の記録が不足していました。このプロジェクトは、コードが生まれる場所でこの部分を担います。サーバー側で推論コストは発生せず、認証情報を受け取ることもありません。

すべてのツールに共通するルールは3つです。

1. 決めつける前に質問します。 不足している要件は、一般的な値で補わず、質問として確認します。
2. 監査可能な入力に基づいて計算します。 価格には出典と日付を明記し、出力には計算式を明示します。
3. ヒューリスティックは一次判定です。 根拠がないまま対応済みとされた管理策は不明に戻し、レビューでは対象外の内容を必ず明示します。

パイプラインでの利用

git clone https://github.com/fernando-moretes/moretes-aws-architect-mcp.git
cd moretes-aws-architect-mcp && npm ci --ignore-scripts && npm run build

terraform show -json tfplan > plan.json
node dist/cli.js call terraform_plan_review --input plan.json --format sarif --fail-on high > review.sarif
# exit 0: ok · 1: achados no nível --fail-on ou acima · 2: erro de uso ou entrada

オフラインで実行でき、利用枠もありません。SARIF は GitHub のコードスキャンに取り込めます。Markdown はジョブの概要に出力されます。GitHub Actions、GitLab CI、pre-commit の設定例はdocs/pipelines.mdにあります。

ローカルでの実行

npm ci --ignore-scripts && npm run build
npm start            # MCP stdio (o protocolo usa o stdout; não é um chat)
npm run http         # http://127.0.0.1:8787/mcp e a landing local
node dist/cli.js list

AWS アカウント関連ツール（STS ID、タグ別リソース、コスト履歴）と公式サーバーとのフェデレーションは、環境変数によるオプトイン方式で、stdio でのみ利用できます。公開 HTTP では決して公開されません。詳細はdocs/clients.mdとdocs/integrations.mdを参照してください。npm ではまだ公開していないため、タグのクローンを使用してください。

動画チュートリアルと無料コース

fernando.moretes.com/mcpでは、クライアントごとの接続方法、実際のサーバーを呼び出すプレイグラウンド、グループ別のツール、ペルソナ、トラブルシューティング、FAQ を確認できます。コースは全10回で、各回に動画、音声、テキスト、クイズ、修了証が用意されています。

プレイグラウンド：例を選び、JSON を編集して、ツールを呼び出します。	レッスン05：意思決定を裏付ける数値。

プライバシーと制限

• 公開サーバーは入力をメモリ上で処理し、リクエスト ID、ステータス、所要時間のみを記録します。引数、プロンプト、結果を記録することはありません。
• インターネットに接続するのは2つのファミリーだけです。aws_knowledge_*（クエリは AWS の公式 MCP に送信されます）とgithub_public_repository（api.github.com）です。それ以外はすべてローカルで計算します。
• クライアントごとの利用枠には、2日間有効なsha256(日付 + IP)を使用します。生の IP アドレスは保存しません。
• 公開エンドポイントには、シークレット、顧客データ、機密性の高いアーキテクチャ情報を送信しないでください。そのためのローカルモードがあります。
• SLA はありません。月額30米ドルを目標予算とする、1人が保守するコミュニティサービスです。

すべてPRIVACY.mdとSECURITY.mdに記載しています。

アーキテクチャ

flowchart LR
  C[Claude Code / Codex / Kiro / Cursor / VS Code] -->|Streamable HTTP| G[API Gateway: 5 rps, rajada 20]
  G --> L[Lambda arm64: 48 ferramentas públicas]
  L --> Q[DynamoDB: cota global e por cliente]
  L --> K[AWS Knowledge MCP oficial]
  L --> H[GitHub: metadados públicos]
  C -->|stdio, opcional| S[MCP local]
  S --> A[Credenciais do SDK + guarda de conta]
  A --> R[3 ferramentas de conta, somente leitura]
  A --> F[Servidores oficiais instalados + allowlist exata]
  P[CLI moretes-architect] --> T[Mesmas ferramentas, offline]

Lambda のロールが書き込めるのは、クォータテーブルと自身のログだけです。デプロイはレビュー済みの CloudFormation 変更セットを使います。設計 · コスト · 運用手順書 · デプロイの証拠

品質

npm run typecheck && npm test && npm run build && npm audit --omit=dev
npm run smoke -- https://m9od37vm41.execute-api.us-east-1.amazonaws.com/mcp   # consulta pública real
node scripts/examples.mjs    # regenera docs/examples com as saídas reais

オフラインテストは 41 件、行カバレッジは 99％で、プロトコル、計算、レビュー、公開データとローカルデータの分離、入力制限、フェデレーションをカバーしています。CI は Node 22 と 24 で実行し、CodeQL、Dependabot、各リリースでの CycloneDX SBOM に対応しています。docs/examples に記載されている各出力はテストです。ツールの動作が変わると、CI が検知します。docs/tools.lock.json には各ツールの名前、説明、スキーマのハッシュが記録されているため、クライアントのモデルが読み取る内容に変更があると、diff に表示されます。

貢献

Issue や PR はポルトガル語または英語で投稿してください。テンプレートを使用してください：バグ またはツールの提案（問題、入力、期待される出力、制限）。新しいツールには、厳密なスキーマ、外部データとの境界の明示、出力における制限事項の記載、テストが必要です。AWS Community Builder、User Group の運営者、または講師の方は、コースや動画を授業で自由にお使いいただけます。

クライアント · ツール · ペルソナ · パイプライン · FAQ · トラブルシューティング · 用語集 · 最新情報 · ワークショップ · 貢献する · 行動規範 · ロードマップ · 変更履歴 · クレジット

_{独立したプロジェクトです。AWS の製品でも、公式の Well-Architected レビューでも、セキュリティ認証でも、価格見積もりでもありません。AWS などの名称は、それぞれの所有者に帰属します。}