mcp-server-appointment-management

mcp-server-appointment-management

このプロジェクトは、データベース内の予約データを管理するために設計された、Java ベースの MCP（Model-Context-Protocol）サーバーです。データアクセスと操作のための内部ツールを公開するモジュール式フレームワークを提供し、AI を活用した機能を標準でサポートしています。

機能

• ユーザーの確認と認証
• 予約のスケジュール設定と管理
• PostgreSQL データベースとの連携

前提条件

• Java 17 以降
• Maven 3.6 以降
• PostgreSQL または mySQL - 他のデータベースも使用できます*
• Spring Boot
• Spring AI 1.0.0-M7

データベースの設定

アプリケーションを実行する前に、データベース接続を設定してください。現在、サーバーは PostgreSQL と MySQL をサポートしています。データベースに接続するには、src/main/resources フォルダーにある application.properties ファイルを更新し、データベースの設定を記述してください：

spring.datasource.url=jdbc:postgresql://localhost:5432/demodb
spring.datasource.username=admin
spring.datasource.password=adminpw

spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.PostgreSQLDialect
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true

トークンベースの認証と認可

このアプリケーションでは、予約管理操作におけるユーザーの認証と認可にトークンを使用します。ユーザーの本人確認が完了すると、一時トークンが生成されます。このトークンは、次のような操作を実行するためのキーとして機能します：

予約の作成 既存の予約の更新 予約のキャンセル 操作が認可されていることを確認するため、各 MCP リクエストにトークンを渡す必要があります。トークンは一定期間が経過すると期限切れになります。または、手動で取り消すこともできます。

• 必要に応じて、認証方式を変更または拡張できます。たとえば、ユーザーログイン機能を実装できます。

トークンのワークフロー例：

1. ユーザーが認証情報を提示してトークンをリクエストします。
2. 確認に成功すると、システムが一時トークンを生成します。
3. 以降のリクエストでトークンを使用し、予約関連の操作を実行します。
4. セキュリティ上の理由から、トークンにはあらかじめ有効期限が設定されています。有効期限は設定ファイルで変更できます。

予約管理

このシステムでは、次の予約管理機能をサポートしています：

1. 予約の作成 ユーザーは新しい予約を作成できます。ユーザーが認証され、認可されると、必要な詳細（時刻、日付、参加者など）を指定して予約をリクエストできます。

2. 予約の更新 有効なトークンを持つユーザーは、既存の予約の詳細を更新できます。これには、予約の時刻、参加者、ステータスの変更が含まれます。

3. 予約のキャンセル ユーザーはシステムを使用して予約をキャンセルできます。キャンセルされると、予約はデータベースから削除され、関連する通知が送信されます。

AI を活用した機能

このアプリケーションは MCP プロトコルを使用することで、AI に予約の更新や管理に関する重要な操作を許可しながら、内部データベースのセキュリティを確保します。このプロトコル層により、内部データベースを直接公開することなく、AI システムが安全にデータへアクセスして操作できるため、機密情報を保護し、認可された操作のみが実行されるようにします。

想定されるユースケース

MCP と AI ツールの連携により、幅広い AI 活用アプリケーションへの道が開かれます：

チャットボットとの連携：

MCP を介して AI を活用したスケジュール管理ツールを公開することで、チャットボットはユーザーの予約、更新、キャンセルを支援できます。これらのチャットボットはユーザーのニーズの文脈を理解し、空き状況や希望に基づいて適切な提案を行えます。

スマートスケジュール管理アシスタント：

AI を活用したスケジュール管理アシスタントは、ユーザーに代わってリアルタイムに判断し、人の直接的なやり取りなしに、予約、日程変更、キャンセルを支援できます。

競合の自動解決：

AI は公開された MCP ツールを使用し、予約スケジュールの競合を事前に解決できます。2 人のユーザーが同じ時間枠を予約しようとした場合、AI が代替案を自動的に提案し、人の介入を最小限に抑えられます。

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

コントリビューションを歓迎します！このプロジェクトに貢献したい場合は、次の手順に従ってください。

1. リポジトリをフォークします。
2. 新しいブランチを作成します（git checkout -b feature-branch）。
3. 変更を加えます。
4. 変更をコミットします（git commit -am 'Added new feature'）。
5. ブランチにプッシュします（git push origin feature-branch）。
6. プルリクエストを作成します。