mcpField
M
mongodb-atlas-checker

mongodb-atlas-checker

github.com/shipshitdevデータ・データベース38166 回インストール2 日前に更新
リポジトリ

mongodb-atlas-checker について

mongodb-atlas-checker は、アプリケーションの MongoDB Atlas 設定を確認するスキルです。接続文字列やドライバー、接続処理、Atlas のアクセス設定を点検し、よくある問題の対処法も示します。

主な機能

  1. 01環境変数と URI の確認
  2. 02ドライバー依存関係の検証
  3. 03接続処理の確認
  4. 04Atlas アクセス設定の点検
  5. 05よくある接続問題の調査

活用シーン

  1. 01デプロイ前の Atlas 設定監査
  2. 02接続文字列の設定ミス特定
  3. 03データベース接続失敗の調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/shipshitdev/skills --skill mongodb-atlas-checker

インストール後、Claude Code で/mongodb-atlas-checkerを入力して読み込まれたか確認します。

同梱ファイルplugin.jsonreferences/full-guide.md

詳細

MongoDB Atlas チェッカー

使用するタイミング

  • MongoDB Atlas のバックエンド設定を検証する場合
  • 接続文字列の設定を確認する場合
  • 環境変数の設定を検証する場合
  • データベース接続の問題をトラブルシューティングする場合
  • デプロイ前にデータベースの設定を監査する場合

クイックチェックリスト

1. 環境変数
  • MONGODB_URI が存在する（ハードコードされていない）
  • mongodb+srv:// プロトコルを使用している（Atlas で必須）
  • データベース名が含まれている
  • retryWrites=true&w=majority が含まれている
  • .env.example に認証情報が含まれていない
2. 接続文字列の形式
mongodb+srv://USERNAME:PASSWORD@CLUSTER-HOST/DATABASE?retryWrites=true&w=majority
3. ドライバーのインストール
  • mongoose または mongodb パッケージがインストールされている
  • 依存関係に含まれている（devDependencies ではない）
4. 接続の設定
  • シングルトンパターン（Next.js）
  • MongooseModule.forRoot()（NestJS）
  • エラー処理が実装されている
5. Atlas の設定
  • IP ホワイトリストが設定されている
  • 権限を持つデータベースユーザーが存在する
  • SSL/TLS が有効になっている（mongodb+srv:// ではデフォルトで有効）

よくある問題

問題解決策
MONGODB_URI がない.env.local または .env に追加する
プロトコルが間違っているmongodb:// ではなく mongodb+srv:// を使用する
複数の接続（Next.js）シングルトンパターンを使用する
接続がタイムアウトするAtlas の IP ホワイトリストを確認する
認証に失敗する認証情報を確認し、特殊文字を URL エンコードする

推奨される接続オプション

{
  retryWrites: true,
  w: 'majority',
  maxPoolSize: 10,
  serverSelectionTimeoutMS: 5000,
  bufferCommands: false,
}

詳細な設定パターン、検証スクリプト、完全な例については、以下を参照してください： references/full-guide.md

コメント

Markdown 対応