tosin2013/mcp-adr-analysis-server

AI駆動の建築分析をClaude・Cursor・Clineに統合するMCPサーバーです。

インストール型ツール自由に使える · MIT企画・設計TypeScript難易度
350 保存
13フォーク12Issue
デモ・公式サイトをひらくtosin2013.github.io

中辛 の解説

TypeScript 製の MCP サーバーで、Node.js 20+ と OpenRouter.ai API(オプション)が必要です。73個のツールを備え、tree-sitter AST 解析・Smart Code Linking・自動 ADR 生成・テスト駆動開発サポートを実装しています。prompt-only モード(API キー不要)と full モード(即座に分析結果を返す)の2つの実行モードがあります。npm でグローバルインストール、または npx で直接実行でき、Claude Desktop・Cline・Cursor・Windsurf など複数のクライアントに対応しています。

こんなリポジトリです

こんなときに便利です

  • AI コーディングアシスタント(Claude、Cline、Cursor)に建築分析機能を統合して、コード生成時に設計上の制約を考慮させたいとき
  • プロジェクトの暗黙的な建築決定を検出し、正式な ADR として文書化・管理したいとき
  • コードベース内のセキュリティリスクを自動検出して、機密情報のマスキング推奨を得たいとき

主な機能

Tree-sitter ベースの AST 解析による言語非依存の技術スタック検出Smart Code Linking により ADR と関連コードを AI が自動発見73個の分析・管理ツール、ADR 生成、セキュリティコンテンツマスキング、テスト駆動開発検証

ほかとの違い

実際の分析結果と信頼度スコアを即座に返すため、他の ADR ツールのようにプロンプト生成に頼らず、本番運用と自動化に適しています。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Node.js 20.0.0以上
  • npm 9.0.0以上(Node.js 20に含まれています)
  • MCP互換クライアント(Claude Desktop、Cline、Cursor、Windsurfなど)
  • OpenRouter.ai API キー(full モード使用時のみ必須)

すぐに始める

  1. Node.js 20.0.0 以上がインストールされていることを確認します。
node --version
  1. mcp-adr-analysis-server をグローバルインストールします。
npm install -g mcp-adr-analysis-server
  1. OpenRouter.ai で API キーを取得します(openrouter.ai/keys)。

  2. クライアント設定ファイルに MCP サーバーを追加します。Claude Desktop の場合、~/Library/Application Support/Claude/claude_desktop_config.json(macOS)または %APPDATA%\Claude\claude_desktop_config.json(Windows)に以下を追加します。

{
  "mcpServers": {
    "adr-analysis": {
      "command": "mcp-adr-analysis-server",
      "env": {
        "PROJECT_PATH": "/path/to/your/project",
        "OPENROUTER_API_KEY": "your_key_here",
        "EXECUTION_MODE": "full"
      }
    }
  }
}
  1. クライアントを再起動して設定を反映させます。

  2. AI アシスタント内で自然言語で質問します。例:"Analyze this React project's architecture and suggest ADRs"

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try tosin2013/mcp-adr-analysis-server

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

これを仕事に活かす

味見がすんだら次は応用です — 仕事やビジネスに活かす方法をまとめました。

レシピ — AI にこのまま頼んでみてください

レシピを読み込んでいます…

スター推移 · 7日

357日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

ベストサンプルサンプル評点 68/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2025 年に作成

「企画・設計」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/tosin2013/mcp-adr-analysis-server.svg)](https://www.gitbap.com/r/tosin2013/mcp-adr-analysis-server)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る