メインコンテンツまでスキップ

MCPサーバー

MBC CQRS Serverlessフレームワーク用のMCP（Model Context Protocol）サーバーです。このパッケージにより、Claude Code、Cursorなどのツールからフレームワークと対話できます。

MCPとは？​

Model Context Protocol（MCP）は、AIツールがアプリケーションやフレームワークと標準化された方法で対話するためのプロトコルです。リソース、ツール、プロンプトの3つの主要な概念を提供します。

機能​

リソース​

フレームワークのドキュメントとプロジェクト情報にアクセスできます。

リソースURI説明
mbc://docs/overview完全なフレームワークドキュメント
mbc://docs/llms-short簡潔なフレームワーク概要
mbc://docs/architectureCQRSアーキテクチャガイド
mbc://docs/errorsソリューション付きエラーカタログ
mbc://docs/faqよくある質問
mbc://docs/troubleshootingトラブルシューティングガイド
mbc://docs/securityセキュリティベストプラクティス
mbc://project/entitiesプロジェクトエンティティ一覧
mbc://project/modulesプロジェクトモジュール一覧
mbc://project/structureプロジェクトディレクトリ構造

ツール​

コード生成とプロジェクト分析ツールを提供します。

ツール説明
mbc_generate_module完全なCQRSモジュールを生成
mbc_generate_controllerコントローラーを生成
mbc_generate_serviceサービスを生成
mbc_generate_entityエンティティを生成
mbc_generate_dtoDTOを生成
mbc_validate_cqrsCQRSパターン実装を検証
mbc_analyze_projectプロジェクト構造を分析
mbc_lookup_errorエラー解決策を検索
mbc_check_anti_patternsコードの一般的なアンチパターンをチェック
mbc_health_checkプロジェクトの健全性チェックを実行
mbc_explain_codeMBCコンテキストでコードを説明

プロンプト​

ガイド付きアシスタンスを提供します。

プロンプト説明
cqrs_implementation_guideステップバイステップのCQRS実装
debug_command_errorコマンド関連エラーのデバッグ
migration_guideバージョン移行ガイダンス

インストール​

npm install @mbc-cqrs-serverless/mcp-server

または npx で直接使用:

npx @mbc-cqrs-serverless/mcp-server

設定​

Claude Code​

以下の設定を追加してください ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "mbc-cqrs-serverless": {
      "command": "npx",
      "args": ["@mbc-cqrs-serverless/mcp-server"],
      "env": {
        "MBC_PROJECT_PATH": "/path/to/your/project"
      }
    }
  }
}

Cursor​

CursorのMCP設定に追加:

{
  "mbc-cqrs-serverless": {
    "command": "npx",
    "args": ["@mbc-cqrs-serverless/mcp-server"],
    "env": {
      "MBC_PROJECT_PATH": "/path/to/your/project"
    }
  }
}

環境変数​

変数説明デフォルト
MBC_PROJECT_PATHプロジェクトディレクトリへのパス現在の作業ディレクトリ

使用例​

モジュール生成​

Claude Codeに以下のように依頼できます:

"Generate a new Order module with async command handling"

プロジェクト分析​

プロジェクト構造を分析します。

"Analyze my project structure"

デバッグ支援​

エラーのデバッグを支援します。

"I'm getting a version mismatch error, help me debug"

コード分析ツール​

バージョン情報

コード分析ツール（mbc_check_anti_patterns、mbc_health_check、mbc_explain_code）はバージョン1.0.22で追加されました。

アンチパターン検出​

mbc_check_anti_patternsツールは一般的なコードの問題を検出します：

コード名前重大度説明
AP001直接DynamoDB書き込み重大直接DynamoDB書き込みの代わりにCommandServiceを使用
AP002バージョン不一致の無視高VersionMismatchErrorをリトライで適切に処理
AP003N+1クエリパターン高ループクエリの代わりにバッチ操作を使用
AP004フルテーブルスキャン高Scanの代わりにキー条件付きQueryを使用
AP005ハードコードされたテナント重大テナントコードにgetUserContext()を使用
AP006テナント検証の欠如重大クライアント提供のテナントコードを信頼しない
AP007同期ハンドラーでのスロー高DataSyncHandlerでエラーを適切に処理
AP008ハードコードされたシークレット重大環境変数またはSecrets Managerを使用
AP009手動JWTパース重大ビルトインのCognitoオーソライザーを使用
AP010重いモジュールインポート中コールドスタートを削減するため必要な関数のみインポート

ヘルスチェック​

mbc_health_checkツールはプロジェクト設定を検証します：

  • MBCフレームワークパッケージのインストール
  • NestJS依存関係
  • TypeScript設定
  • 環境ファイルのセットアップ
  • ソースディレクトリ構造
  • Serverless設定

コード説明​

mbc_explain_codeツールはコードを分析して説明します：

  • NestJSモジュール構造とインポート
  • RESTコントローラーエンドポイント
  • サービスパターンと依存関係
  • エンティティ定義とDynamoDBキー
  • CQRSコマンド発行パターン
  • データ同期ハンドラーの動作

Claude Code Skills​

バージョン情報

Claude Code Skillsはバージョン1.0.24で追加されました。

Claude Code Skillsは、MBC CQRS Serverless開発のためのガイド付きアシスタンスを提供します。Skillsは、開発者が一般的なタスクを行うための特化したプロンプトです。

利用可能なSkills​

Skill説明
/mbc-generateボイラープレートコードを生成（モジュール、サービス、コントローラー、DTO、ハンドラー）
/mbc-reviewベストプラクティスとアンチパターン（20パターン）のコードレビュー
/mbc-migrateバージョン移行と破壊的変更のガイド
/mbc-debug一般的な問題のデバッグとトラブルシューティング

Skillsのインストール​

CLIを使用（推奨）​

最も簡単なインストール方法はMBC CLIを使用することです：

# 個人skillsディレクトリにインストール（すべてのプロジェクトで利用可能）
mbc install-skills

# プロジェクトディレクトリにインストール（gitでチームと共有）
mbc install-skills --project

# 利用可能なskillsを一覧表示
mbc install-skills --list

# 既存のskillsを強制上書き
mbc install-skills --force

手動インストール​

または、Claude Codeのskillsディレクトリに手動でコピーできます：

# 個人skillsにコピー（すべてのプロジェクトで利用可能）
cp -r node_modules/@mbc-cqrs-serverless/mcp-server/skills/* ~/.claude/skills/

# またはプロジェクトskillsにコピー（チームで共有）
cp -r node_modules/@mbc-cqrs-serverless/mcp-server/skills/* .claude/skills/

/mbc-generate Skill​

MBC CQRS Serverlessのベストプラクティスに従ってボイラープレートコードを生成します。

コアテンプレート：

  • モジュール、コントローラー、サービス、DTO、DataSyncHandler

追加テンプレート：

  • カスタムイベント処理用のイベントハンドラー
  • 複雑な検索用のクエリハンドラー
  • Elasticsearch同期ハンドラー
  • GraphQLリゾルバー

使用例：

/mbc-generate
Create an Order module with RDS synchronization

/mbc-review Skill​

MBC CQRS Serverlessのベストプラクティスに基づいてコードをレビューし、アンチパターンを特定します。

検出されるアンチパターン（20パターン）：

コード説明重大度
AP001publishAsyncの代わりにpublishSyncを使用警告
AP002マルチテナント操作でtenantCodeが欠落エラー
AP003ハードコードされたバージョン番号エラー
AP004DataSyncHandlerの登録漏れエラー
AP005ConditionalCheckFailedExceptionを処理していない警告
AP006誤ったPK/SK形式の使用エラー
AP007サービスメソッドでinvokeContextが欠落エラー
AP008エンティティIDにgenerateIdを使用していない警告
AP009DTOバリデーションデコレーターが欠落警告
AP010非推奨メソッドの使用警告
AP011トレーシング用のgetCommandSourceが欠落警告
AP012DataServiceの代わりに直接DynamoDBアクセス警告
AP013DataSyncHandlerでtype宣言が欠落エラー
AP014DetailKey型を使用していない情報
AP015ハードコードされたテーブル名警告
AP016エラーログが欠落警告
AP017不正な属性マージエラー
AP018Swaggerドキュメントが欠落情報
AP019ページネーションを正しく処理していない警告
AP020モジュールの循環依存エラー

使用例：

/mbc-review
Review the code in src/order/order.service.ts

/mbc-migrate Skill​

MBC CQRS Serverlessフレームワークのバージョン移行をガイドします。

機能：

  • バージョン移行マトリックス（v1.0.16からv1.0.23）
  • 各バージョンの詳細な移行ガイド
  • 非推奨APIの移行手順
  • 移行チェックリスト（移行前、移行中、移行後）
  • バージョン互換性マトリックス

使用例：

/mbc-migrate
I need to upgrade from v1.0.20 to v1.0.23

/mbc-debug Skill​

MBC CQRS Serverlessアプリケーションの問題のデバッグとトラブルシューティングを支援します。

機能：

  • エラーコードクイックルックアップ
  • 6つのデバッグワークフロー（コマンド、ConditionalCheckFailedException、DataSyncHandler、テナント、インポート、パフォーマンス）
  • CloudWatchログクエリ
  • ローカル開発デバッグ（LocalStack、Serverless Offline）
  • トラブルシューティング決定木

使用例：

/mbc-debug
I'm getting ConditionalCheckFailedException errors

関連パッケージ​