MCP Adr Analysis Server

🚀 MCP ADR分析サーバー

このサーバーは、AIによるアーキテクチャ決定分析とADR管理を提供するMCPサーバーです。実際の分析結果を返し、他の場所に提出するようなプロンプトではありません。

🚀 クイックスタート

概要

• 対象：AIコーディングアシスタント（Claude、Cline、Cursor）、エンタープライズアーキテクト、開発チーム
• 目的：95％の信頼度スコアで、プロンプトではなく即座にアーキテクチャの洞察を得る
• 方法：npm install -g mcp-adr-analysis-server → OpenRouter APIで設定 → 分析を開始

インストール

# オプション1: グローバルインストール (頻繁に使用する場合を推奨)
npm install -g mcp-adr-analysis-server

# オプション2: npxを使用 (インストール不要)
npx mcp-adr-analysis-server

# オプション3: RHEL 9/10システム (特別なインストーラー)
curl -sSL https://raw.githubusercontent.com/tosin2013/mcp-adr-analysis-server/main/scripts/install-rhel.sh | bash

📖 詳細なインストールガイド → | RHELセットアップ →

セットアップ（3ステップ）

1. APIキーを取得：OpenRouter.ai/keys
2. 環境を設定：OPENROUTER_API_KEY=your_key + EXECUTION_MODE=full
3. クライアントを構成：Claude Desktop、Cline、Cursor、またはWindsurfに追加

{
  "mcpServers": {
    "adr-analysis": {
      "command": "mcp-adr-analysis-server",
      "env": {
        "PROJECT_PATH": "/path/to/your/project",
        "OPENROUTER_API_KEY": "your_key_here",
        "EXECUTION_MODE": "full"
      }
    }
  }
}

📖 完全な構成ガイド → | クライアントセットアップ →

✨ 主な機能

• 🤖 AIによる分析 - OpenRouter.aiとの統合により即座にアーキテクチャの洞察を得る
• 🏗️ 技術検出 - あらゆる技術スタックとアーキテクチャパターンを識別する
• 📋 ADR管理 - アーキテクチャ決定レコードを生成、提案、維持する
• 🔗 スマートコードリンク - AIによるADRと決定に関連するコードファイルの検出
• 🛡️ セキュリティとコンプライアンス - 敏感な内容を自動的に検出しマスクする
• 🧪 TDD統合 - 検証を伴う2段階のテスト駆動開発
• 🚀 デプロイ準備検証 - 厳格なブロッキングによるゼロトレランスのテスト検証

📖 全機能を表示 →

📦 インストールガイド

# オプション1: グローバルインストール (頻繁に使用する場合を推奨)
npm install -g mcp-adr-analysis-server

# オプション2: npxを使用 (インストール不要)
npx mcp-adr-analysis-server

# オプション3: RHEL 9/10システム (特別なインストーラー)
curl -sSL https://raw.githubusercontent.com/tosin2013/mcp-adr-analysis-server/main/scripts/install-rhel.sh | bash

📖 詳細なインストールガイド → | RHELセットアップ →

💻 使用例

基本的な使用法

// 基本的なプロジェクト分析
const analysis = await analyzeProjectEcosystem({
  projectPath: '/path/to/project',
  analysisType: 'comprehensive',
});

// 要件からADRを生成
const adrs = await generateAdrsFromPrd({
  prdPath: 'docs/PRD.md',
  outputDirectory: 'docs/adrs',
});

// スマートコードリンク - ADR決定に関連するコードを検索
const relatedCode = await findRelatedCode(
  'docs/adrs/001-auth-system.md',
  'We will implement JWT authentication with Express middleware',
  '/path/to/project',
  {
    useAI: true, // AIによるキーワード抽出
    useRipgrep: true, // 高速なテキスト検索
    maxFiles: 10, // 結果を制限
    includeContent: true, // ファイル内容を含む
  }
);

高度な使用法

Claude（または任意のMCPクライアント）に問い合わせる：

• "このReactプロジェクトのアーキテクチャを分析し、暗黙の決定に対するADRを提案してください"
• "PRD.mdファイルからADRを生成し、実装タスクを含むtodo.mdを作成してください"
• "このコードベースのセキュリティ問題をチェックし、マスキングの推奨事項を提供してください"

サーバーは実際の分析結果を返します。他の場所に提出するようなプロンプトではありません！

📖 完全な使用ガイド → | APIリファレンス →

📚 詳細ドキュメント

MCPとは？

モデルコンテキストプロトコル（MCP）は、AIアシスタントと外部ツールのシームレスな統合を可能にします。このサーバーは、AIアシスタントに深いアーキテクチャ分析機能を提供し、インテリジェントなコード生成、決定追跡、および開発ワークフローの自動化を可能にします。

🎯 ユースケース

• 👨‍💻 AIコーディングアシスタント - Claude、Cline、Cursorにアーキテクチャの知能を追加する
• 💬 会話型AI - 信頼度スコアを伴うアーキテクチャの質問に答える
• 🤖 自律エージェント - 継続的な分析とルールの施行
• 🏢 エンタープライズチーム - ポートフォリオ分析と移行計画

📖 詳細なユースケース →

🛠️ 技術スタック

• ランタイム：Node.js 20+
• 言語：TypeScript
• フレームワーク：MCP SDK
• テスト：Jest（80％以上のカバレッジ）
• 検索：ripgrep + fast-glob
• AI統合：OpenRouter.ai
• Webリサーチ：Firecrawl
• コード分析：スマートコードリンク

📖 技術詳細 →

📁 プロジェクト構造

src/tools/     # 23のMCP分析ツール
docs/adrs/     # アーキテクチャ決定レコード
tests/         # 80％以上のテストカバレッジ
.github/       # CI/CD自動化

📖 完全な構造 →

🧪 テスト

npm test              # すべてのテストを実行 (80％以上のカバレッジ)
npm run test:coverage # カバレッジレポートを生成

📖 テストガイド →

🔥 Firecrawl統合（オプション）

包括的なアーキテクチャ分析のための拡張されたWebリサーチ機能

# オプション1: クラウドサービス (推奨)
export FIRECRAWL_ENABLED="true"
export FIRECRAWL_API_KEY="fc-your-api-key-here"

# オプション2: セルフホスト
export FIRECRAWL_ENABLED="true"
export FIRECRAWL_BASE_URL="http://localhost:3000"

# オプション3: 無効化 (デフォルト - Web検索なしでサーバーは動作する)

メリット：リアルタイムリサーチ • 強化されたADR • ベストプラクティスの発見 • インテリジェントなWebスクレイピング

📖 Firecrawlセットアップガイド →

🔧 開発

git clone https://github.com/tosin2013/mcp-adr-analysis-server.git
cd mcp-adr-analysis-server
npm install && npm run build && npm test

品質基準：TypeScriptのstrictモード • ESLint • 80％以上のテストカバレッジ • プリコミットフック

📖 開発ガイド → | コントリビュート →

🔧 トラブルシューティング

一般的な問題：

• RHELシステム：特別なインストーラースクリプトを使用する
• ツールがプロンプトを返す：EXECUTION_MODE=fullとAPIキーを設定する
• モジュールが見つからない：npm install && npm run buildを実行する
• パーミッションエラー：ファイルパーミッションとプロジェクトパスを確認する

📖 完全なトラブルシューティングガイド →

🔒 セキュリティとパフォーマンス

• セキュリティ：自動シークレット検出 • 内容マスキング • ローカル処理 • ゼロトラスト
• パフォーマンス：多段階キャッシュ • インクリメンタル分析 • 並列処理 • メモリ最適化

📖 セキュリティガイド → | パフォーマンス →

🔐 セキュリティ脆弱性の報告

セキュリティ問題を発見した場合は、責任ある開示手順についてセキュリティポリシーを読んでください。セキュリティ脆弱性については、公開イシューを作成しないでください。

🤝 コントリビュート

私たちはコントリビューションを歓迎します！バグの修正、機能の追加、またはドキュメントの改善など、あなたの助けを大いに歓迎します。

🌟 コントリビューターのクイックスタート

1. リポジトリをフォーク
2. フォークをクローン：git clone https://github.com/YOUR_USERNAME/mcp-adr-analysis-server.git
3. ブランチを作成：git checkout -b feature/your-feature-name
4. テストを含めて変更を加える
5. テストを実行：npm test（80％以上のカバレッジを維持）
6. プルリクエストを提出

👶 初めてのコントリビューション？

初心者にやさしいタスクを探している場合は、good first issuesをチェックしてください。これらは、始めるのに最適なタスクです！

オープンソースが初めて？ 私たちのコントリビュートガイドが、全プロセスをステップバイステップで案内します。

📝 イシューの報告

バグを報告する際や機能を要求する際は、イシューテンプレートを使用してください。テンプレートは、私たちが問題を理解して解決するのを助けます。

基準：TypeScriptのstrictモード • 80％以上のカバレッジ • ESLint • セキュリティ検証 • MCP準拠

📖 完全なコントリビュートガイド → | 行動規範 →

🔗 リソース

• 公式：MCP仕様 • MCP SDK
• コミュニティ：MCPレジストリ • Discord
• プロジェクト：ADRs • 進捗状況 • 公開ガイド

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Anthropic：モデルコンテキストプロトコルを作成してくれた
• MCPコミュニティ：インスピレーションとベストプラクティスを提供してくれた
• コントリビューター：このプロジェクトをより良くするために協力してくれた

Author: Tosin Akinosho | Repository: GitHub

❤️によって構築された Tosin AkinoshoによるAI駆動のアーキテクチャ分析

AIアシスタントに深いアーキテクチャ知能と意思決定能力を付与する。