IAMZOE MCP SERVER

🚀 基于Neo4jの予約システムMCPサーバー

このプロジェクトは、Neo4jグラフデータベースに基づいて構築された予約システムMCPサーバーです。予約管理、顧客管理、従業員管理、サービス管理、レポート分析などの機能をサポートし、Claudeなどの大型言語モデルに完全なMCPツールセットを提供します。

🚀 クイックスタート

この予約システムMCPサーバーを使用することで、予約管理や顧客管理などの業務を効率的に行うことができます。以下の手順に従って、サーバーを起動してください。

✨ 主な機能

• 予約管理：予約の作成、照会、更新、キャンセルを実現します。
• 顧客管理：顧客の情報を管理および照会します。
• 従業員管理：従業員の情報を管理および照会します。
• サービス管理：予約可能なサービスやプロジェクトを管理します。
• カテゴリ管理：サービスのカテゴリを維持および管理します。
• 会員等級管理：会員等級と関連する特典を管理します。
• 従業員可用性管理：従業員の勤務時間と利用可能な状態を設定および管理します。
• 従業員サービス能力管理：従業員が提供できる具体的なサービスを定義します。
• 通知システム：顧客に予約のリマインダーやその他の通知を送信します。
• ビジネス統計：業務データの統計と分析機能を提供します。
• 広告管理：広告コンテンツの作成と審査を行います。
• ユーザー関係管理：ユーザー間の関係ネットワークを維持します。

🔧 技術詳細

• バックエンドフレームワーク：Node.js
• データベース：Neo4jグラフデータベース
• MCP統合：@modelcontextprotocol/sdk

📦 インストール

1. Node.jsとNeo4jデータベースがインストールされていることを確認してください。
2. プロジェクトをローカル開発環境にクローンします。
3. ターミナルで以下のコマンドを実行して依存関係をインストールします：npm install
4. .env.exampleファイルをコピーして.envにリネームし、対応する環境変数を設定します。
5. 初期化コマンドを実行します：npm run initialize
6. サーバーを起動します：npm start

📚 ドキュメント

開発フローの説明

このプロジェクトでは、以下の開発ワークフローが提供されています。

注意事項

• initializeコマンドは、初回のデプロイまたはリソースの再生成が必要な場合にのみ使用してください。
• 日常の開発では、npm run devを使用することをお勧めします。
• 本番環境では、npm startを使用することをお勧めします。

環境変数の設定

このプロジェクトを実行するために必要な環境変数は以下の通りです。

# データベース接続情報
NEO4J_URI=bolt://localhost:7687
NEO4J_USER=neo4j
NEO4J_PASSWORD=your_password

# その他の設定オプション（オプション）
NODE_ENV=development
PORT=3000

プロジェクト構造の説明

src/
├── tools/           # MCPツール定義フォルダ、LLMとのやり取りに使用
├── utils/          # ユーティリティ関数と補助関数
├── models/         # データモデルとビジネスロジックの実装
├── routes/         # APIルート定義（内部使用のみ）
└── config/         # プロジェクトの設定ファイル

データベースモデルの説明

このシステムでは、以下の主要なノードタイプが定義されています。

• Customer：ユーザー情報ノード
• Employee：従業員情報ノード
• Service：予約可能なサービスノード
• Appointment：予約記録ノード
• Notification：通知記録ノード
• Advertisement：広告コンテンツノード

すべてのノードは関係属性を介して接続されており、データの照会が効率的かつ正確に行えます。

データベース最適化の説明

npm run initializeコマンドを実行すると、システムは必要なインデックスと制約を自動的に作成し、照会パフォーマンスを向上させ、データの一貫性を保証します。具体的には以下のことが行われます。

• 頻繁に照会されるフィールドにインデックスを追加します。
• 一意性制約を設定して重複データを回避します。
• 関連関係を作成して複雑な照会を最適化します。

MCPツールの説明

このプロジェクトは、ClaudeなどのLLMにさまざまなMCPツールを提供します。ツール定義ファイルはsrc/tools/ディレクトリにあります。初期化コマンドを実行すると、完全なツールドキュメントが自動的に生成されます。

詳細な使用ガイドについては、docs/Tools-Usage-Guide.mdを参照してください。

連絡先

フィードバックや技術的なサポートが必要な場合は、プロジェクトの担当者に連絡してください。

⚠️ 重要提示

このリポジトリは純粋なMCPサーバーブランチであり、すべてのAPI関連コードは削除されています。