sawadari/requirements-mcp-server

requirements-mcp-server

要求管理MCPサーバー - Claude Codeとの対話的な要求管理システム

📘 プロジェクトランディングページ - 効果実績、アーキテクチャ、はじめ方を詳しく解説

📘 人間中心AI時代の組織憲章 - 設計の前提条件

✨ 主な機能

コア機能 (MCPサーバー)

• 🔧 22個のMCPツール - CRUD (5), 検索・分析 (3), 検証 (3), Fix Engine (4), 変更管理 (1), プロジェクト管理 (6)
• ✅ 自動検証 - 5つのドメインで品質チェック（階層、グラフ、抽象度、MECE、スタイル）
• 🔄 Fix Engine - ポリシーベースの自動修正とロールバック (6種類の修正操作)
• 🎯 オントロジー管理 - カスタマイズ可能な要求段階定義
• 📊 プロジェクト管理 - 複数プロジェクトの切り替えと管理
• 🔍 影響分析 - 依存関係を自動追跡し影響範囲を特定

補助機能 (別プロセス)

• 🌐 Webビューアー - インタラクティブなブラウザUIで要求を可視化 (npm run view-server)
• 🤖 AIチャット統合 (実験的) - Claude搭載の対話型アシスタント

🚀 クイックスタート

1. インストール

git clone https://github.com/sawadari/requirements-mcp-server.git
cd requirements-mcp-server
npm install
npm run build

2. MCPサーバーとして起動

MCPサーバー + Webビューアー（推奨）:

npm run dev

→ MCPサーバーとWebビューアー (http://localhost:5002) が同時起動

MCPサーバーのみ:

npm run mcp-only

Webビューアーのみ:

npm run view-server

3. Claude Codeに接続

.claude/mcp-servers.json に以下を追加:

{
  "mcpServers": {
    "requirements": {
      "command": "node",
      "args": ["C:/dev/requirements-mcp-server/build/index.js"]
    }
  }
}

4. 使ってみる

Claude Codeで自然言語で要求を管理：

新しい要求を追加してください。
タイトル: ユーザー認証機能
説明: JWTを使用したユーザー認証システム
優先度: high
カテゴリ: セキュリティ

📚 ドキュメント

🎓 はじめに

📖 ユーザーガイド

🔧 高度な機能

👨‍💻 開発者向け

📋 リファレンス

📖 - 全ドキュメント一覧とキーワード検索

💡 使用例

例1: 要求を追加して検証

# Claude Codeで実行
"新しい要求を追加してください"
→ add_requirement ツールが実行される

"要求REQ-123の妥当性をチェックしてください"
→ validate_requirement ツールが実行される

例2: 影響範囲を分析

"要求REQ-123の影響範囲を分析してください"
→ analyze_impact ツールが実行される
→ 影響を受ける要求、推定工数、リスクが表示される

例3: Webビューアーで可視化

npm run view-server
# http://localhost:5002 にアクセス

詳細は を参照

🌐 Webビューアー

インタラクティブなWebインターフェースで要求を管理：

npm run view-server

http://localhost:5002 にアクセス

主な機能:

• ツリービュー（階層構造表示）
• 検索・フィルター
• トレーサビリティマトリックス
• AIチャットアシスタント
• リアルタイム自動更新

詳細は を参照

🔧 MCPツール（22個）

CRUD操作（5ツール）

• add_requirement - 要求追加
• get_requirement - 要求取得
• list_requirements - 要求一覧
• update_requirement - 要求更新
• delete_requirement - 要求削除

検索・分析（3ツール）

• search_requirements - 条件検索
• analyze_impact - 影響範囲分析
• get_dependency_graph - 依存関係グラフ

検証・品質（3ツール）

• validate_requirement - 単一要求検証
• validate_all_requirements - 全要求検証
• get_validation_report - 検証レポート

変更管理（1ツール）

• propose_change - 変更提案作成

Fix Engine（4ツール）

• load_policy - ポリシー読込
• preview_fixes - 修正プレビュー
• apply_fixes - 修正適用
• rollback_fixes - ロールバック

プロジェクト管理（6ツール）

• list_projects - プロジェクト一覧
• get_current_project - 現在のプロジェクト
• switch_project - プロジェクト切替
• create_project - プロジェクト作成
• delete_project - プロジェクト削除
• infer_and_switch_project - 自然言語からプロジェクト推論・切替

詳細は を参照

🏗️ アーキテクチャ

┌──────────────────────────────────────────┐
│        Claude Code (MCP Client)          │
└──────────────┬───────────────────────────┘
               │ JSON-RPC (stdio)
┌──────────────▼───────────────────────────┐
│   requirements-mcp-server (22 tools)     │
├──────────────────────────────────────────┤
│  MCP Layer: 22 Tool Handlers             │
│  Business: Analyzer, Validator           │
│  Fix Engine: Executor, Planner, Change   │
│  Ontology: OntologyManager               │
│  Data: Storage, ProjectManager, Logger   │
└──────────────┬───────────────────────────┘
               │
┌──────────────▼───────────────────────────┐
│   data/requirements.json (storage)       │
└──────────────────────────────────────────┘

詳細は を参照

🤖 Miyabiフレームワーク統合

このプロジェクトはMiyabi（自律型開発フレームワーク）で構築されています：

• 7つの自律エージェント - Coordinator、Issue、CodeGen、Review、PR、Deployment、Test
• GitHubをOSとして - Issue → 実装 → PR → デプロイの自動化
• 識学理論準拠 - 責任の明確化、権限委譲、曖昧性の排除

詳細は を参照

🧪 テスト

# 全テスト実行
npm test

# カバレッジレポート
npm run test:coverage

# Watch mode
npm run test:watch

目標カバレッジ: 80%+

🛠️ 開発

開発モード

npm run dev

ビルド

npm run build

型チェック

npm run typecheck

プロジェクト管理スクリプト

プロジェクト一覧表示:

npm run list-projects

プロジェクト削除:

# 対話モード
npm run delete-project

# 直接指定
npm run delete-project <project-id>

注意: デフォルトプロジェクト（requirements）は削除できません

📊 プロジェクト統計

• MCPツール: 22個
• テストカバレッジ: 80%+
• ドキュメントページ: 20+
• 対応言語: TypeScript (strict mode)
• MCP SDK: 1.20.1

🤝 貢献

Issue、Pull Requestを歓迎します。

開発に参加する場合は以下を参照：

📄 ライセンス

MIT License - 詳細は を参照

🔗 リンク

• プロジェクトサイト: https://sawadari.github.io/requirements-mcp-server/
• 組織憲章: https://sawadari.github.io/principle/
• Model Context Protocol: https://modelcontextprotocol.io/
• Claude Code: https://docs.claude.com/claude-code
• Miyabi Framework: https://github.com/ShunsukeHayashi/Autonomous-Operations

📞 サポート

質問や問題がある場合は、GitHub Issuesで報告してください。