Mongodb MCP Server 3o3

🚀 MongoDB モデルコンテキストプロトコル（MCP）サーバー

MongoDB モデルコンテキストプロトコル（MCP）サーバーは、MongoDB 操作を MCP 規格に準拠した形式で行い、LLM クライアントに構造化データを返すことができるサーバーです。

🚀 クイックスタート

1. 依存関係のインストール

npm install

2. プロジェクトのビルド

npm run build

3. 開発モードでの起動

npm run dev

4. テストの実行

npm test

✨ 主な機能

• データベース接続：提供された MongoDB 接続文字列で接続を確立します。
• 操作ツール：MongoDB 操作を MCP 規格に準拠したツールに変換します。
• 入力検証：Zod を使用して型安全とセキュリティを検証します。
• クエリ実行：クエリを実行し、構造化データを LLM クライアントに返します。
• 接続プール管理：接続プールとエラーを処理し、安定した動作を保証します。

📦 インストール

ローカル実行

npx を使用して、「クイックスタート」で説明した手順で実行できます。

グローバルインストール

npm を使用してグローバルパッケージをインストールします。

npm install -g @coderay/mongo-mcp-server

Docker コンテナ

リポジトリ内の Dockerfile を参照してデプロイします。

プラットフォームサービス

Heroku、Vercel、AWS などのプラットフォームでサービスとしてデプロイできます。

🔧 技術詳細

• TypeScript：型安全な開発に使用されます。
• MongoDB Node.js ドライバー：データベース操作に使用されます。
• Zod：スキーマ検証に使用されます。
• モデルコンテキストプロトコル SDK：サーバーの実装に使用されます。

🔒 セキュリティに関する注意事項

1. 専用の MongoDB ユーザーを作成します。
2. 管理用の資格情報を使用しないでください。
3. アクセスログの記録を有効にします。
4. 適切な読み書き権限を設定します。
5. 接続文字列パラメータを使用します。
6. IP ホワイトリストを検討します。

⚠️ 重要注意

常に最小特権の原則に従ってデータベースアクセスを構成してください。

📚 ドキュメント

仕組み

1. 提供された MongoDB 接続文字列で接続を確立します。
2. MongoDB 操作を MCP 規格に準拠したツールとして公開します。
3. Zod を使用して入力を検証し、型安全とセキュリティを確保します。
4. クエリを実行し、構造化データを LLM クライアントに返します。
5. 接続プールとエラー処理を管理します。

利用可能なツール

クエリツール

• listCollections：データベース内の利用可能なコレクションをリストします。
• find：フィルターと投影に基づいてドキュメントをクエリします。
• insertOne：コレクションに単一のドキュメントを挿入します。
• updateOne：コレクション内の単一のドキュメントを更新します。
• deleteOne：コレクションから単一のドキュメントを削除します。

インデックスツール

• createIndex：コレクション上に新しいインデックスを作成します。
• dropIndex：コレクションからインデックスを削除します。
• indexes：コレクションのインデックスをリストします。

🤝 コントリビューションガイド

コントリビューションを歓迎します！ 以下の手順でプルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更をコミットします。
4. ブランチにプッシュします。
5. プルリクエストを開きます。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。