Jbassist

🚀 JBassist - マイクロソフトグラフ MCP サーバー

Windows 互換の MCP サーバー実装で、Claude Desktop が Microsoft Graph API を介して Microsoft 365 サービスに接続できるようにします。

🚀 クイックスタート

このプロジェクトは MCP サーバーで、Claude Desktop が Microsoft Graph API を介して Microsoft 365 サービスに接続できるようにします。MCP（モデルコンテキストプロトコル）は、異なるシステム間で情報を伝達するためのプロトコルです。

✨ 主な機能

標準 API ツール

この実装には、以下の標準的な Microsoft Graph API 機能が含まれています。

• ユーザープロフィール情報の取得
• メールの送受信
• カレンダー操作
• ファイルストレージへのアクセス

Beta API ツール

この実装には、以下のベータ版の Microsoft Graph API 機能も含まれています。

• 拡張されたユーザープロフィール情報
• 組織関係グラフ
• ユーザーの状態と存在情報
• 高度な検索機能

📦 インストール

前提条件

この MCP サーバーを使用するには、以下の前提条件が必要です。

1. Node.js と npm をインストールする（バージョン要件：Node >= 14、npm >= 6）
2. TypeScript をインストールする（オプションですが推奨）
3. Microsoft グラフ Graph クライアントライブラリをインストールする
4. Azure AD アプリケーションを登録し、アクセストークンを取得する

セットアップ手順

1. このリポジトリをローカル開発環境にクローンします。
2. プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を記入します。

   TENANT_ID=your_tenant_id
   CLIENT_ID=your_client_id
   CLIENT_SECRET=your_client_secret
   

3. 依存関係をインストールする：コマンド npm install を実行します。
4. サーバーを起動する：コマンド npm start を実行します。

サーバーの実行方法

• サーバーが起動すると、コンソールに関連情報が出力され、指定されたポートを監視します。
• 設定ファイルを使用して、サーバーのポート番号とログレベルを調整できます。

💻 使用例

基本的な使用法

標準 API の例

// 現在のユーザープロフィールを取得する
GET /api/user-profile

// メールを送信する
POST /api/send-email
{
  "to": "recipient@example.com",
  "subject": "Test Email",
  "body": "This is a test email."
}

Beta API の例

// 拡張されたユーザープロフィールを取得する
GET /api/beta-user-profile

// Marketing 部門で SQL スキルを持つユーザーを検索する
POST /api/search-users
{
  "department": "Marketing",
  "skills": ["SQL"]
}

📚 ドキュメント

トラブルシューティング

1. 認証エラー：.env ファイル内の Azure AD アプリケーションの資格情報が正しいことを確認してください。
2. 権限エラー：Azure AD アプリケーションが必要な権限を持っていることを確認してください。
3. 接続問題：Claude Desktop の MCP 承認ボタンをクリックしたことを確認してください。
4. ログファイル：graph-server.log ファイルを確認して、詳細なエラー情報を取得してください。

開発情報

サーバーの変更または新機能の追加

1. src ディレクトリ内のファイルを編集します。
2. src/index.ts で既存のパターンに従って新しいツールを追加します。
3. プロジェクトを再構築する：コマンド npm run build を実行します。
4. サーバーを再起動します。

新しい Beta API 機能の追加

1. Microsoft Graph のベータ API ドキュメントを参照してください。
2. graphBetaClient インスタンスを使用してベータ API を呼び出します。
3. ベータ API は変更される可能性があるため、十分なテストとエラー処理を行ってください。

追加の Microsoft Graph エンドポイント

このサーバーは基本的な機能を実装していますが、Microsoft Graph はさらに多くのエンドポイントを提供しています。例えば：

• OneNote へのアクセス
• SharePoint ドキュメントへのアクセス
• Teams メッセージへのアクセス
• OneDrive ファイルへのアクセス
• タスク管理

詳細情報については、Microsoft Graph 公式ドキュメント を参照してください。

📄 ライセンス

MIT

謝辞

このプロジェクトは、Windows MCP 天気サンプルプロジェクトをベースに、Microsoft Graph 用に調整されています。