Webex Messaging MCP Server

🚀 Webex MCP Server

このModel Context Protocol (MCP) サーバーは、AIアシスタントにCisco Webexのメッセージング機能への包括的なアクセスを提供します。

🚀 クイックスタート

前提条件

• Node.js 18以上 (20以上を推奨)。注意: Nodeのバージョンが低いとfetchが使用できません。ツールはHTTP呼び出しにfetchを使用しています。この問題を回避するには、ツールをnode-fetchを使用するように変更してください。node-fetchを依存関係としてインストールし、各ツールファイルにfetchとしてインポートしてください。
• Docker (コンテナ化されたデプロイの場合はオプション)
• developer.webex.com から取得したWebex APIトークン

トークンの更新

Webexのベアラートークンは短期間で有効です。現在のトークンは12時間で期限切れになります。更新するには:

1. 次のURLにアクセスします: https://developer.webex.com/messaging/docs/api/v1/rooms/list-rooms
2. メールアドレスでログインします
3. プロファイルから新しいベアラートークンをコピーします
4. 環境変数 "WEBEX_PUBLIC_WORKSPACE_API_KEY" を新しいトークンで更新します ("Bearer " の接頭辞を削除してください)

インストール

1. リポジトリをクローンし、依存関係をインストールします:

   git clone <repository-url>
   cd webex-messaging-mcp-server
   npm install
   

2. 環境を構成します:

   cp .env.example .env
   # .env をWebex APIトークンで編集します
   

3. サーバーをテストします:

   # 利用可能なツールをリストします
   node index.js tools
   
   # MCPサーバーを起動します
   node mcpServer.js
   

Dockerの使用

1. ビルドして実行します:

   docker build -t webex-mcp-server .
   docker run -i --rm --env-file .env webex-mcp-server
   

2. docker-composeを使用します:

   docker-compose up webex-mcp-server
   

✨ 主な機能

• ✅ 完全なWebex APIカバレッジ: 主要なメッセージング操作を網羅する52のツール
• ✅ Dockerサポート: 本番環境で使用可能なコンテナ化
• ✅ デュアルトランスポート: STDIOとSSE (Server-Sent Events) の両方のモード
• ✅ エンタープライズ対応: Ciscoエンタープライズ認証をサポート
• ✅ タイプセーフ: 適切なエラーハンドリングを備えた完全なTypeScript/JavaScript実装
• ✅ 集中管理された構成: トークンとエンドポイントの管理が容易

📚 ドキュメント

概要

このMCPサーバーは、AIアシスタントがWebexメッセージングと次の52の異なるツールを通じてやり取りできるようにします:

• メッセージ: メッセージの送信、編集、削除、および取得
• ルーム: Webexスペースの作成と管理
• チーム: チームの作成とメンバーシップ管理
• ユーザー: ユーザー管理とディレクトリ操作
• Webhook: イベント通知と統合
• エンタープライズ機能: ECMフォルダ、ルームタブ、および添付ファイル

設定

環境変数

Webex APIトークンの取得方法

1. developer.webex.com にアクセスします
2. Cisco/Webexアカウントでサインインします
3. APIドキュメントからベアラートークンをコピーします
4. 重要: .env ファイルに追加する際に "Bearer " の接頭辞を削除してください

MCPクライアントの統合

Claude Desktop

Claude Desktopの設定に追加します:

{
  "mcpServers": {
            "webex-messaging": {
                "command": "docker",
                "args": [
                  "run",
                  "-i",
                  "--rm",
                  "-e",
                  "WEBEX_PUBLIC_WORKSPACE_API_KEY",
                  "-e",
                  "WEBEX_USER_EMAIL",
                  "-e",
                  "WEBEX_API_BASE_URL",
                  "webex-mcp-server"
                ],
                "env": {
                  "WEBEX_USER_EMAIL": "your.email@company.com",
                  "WEBEX_API_BASE_URL": "https://webexapis.com/v1",
                  "WEBEX_PUBLIC_WORKSPACE_API_KEY": "your_token_here"
                }
            },
  }
}

その他のMCPクライアント

STDIOモードの場合:

docker run -i --rm --env-file .env webex-mcp-server

SSEモードの場合:

docker run -p 3001:3001 --rm --env-file .env webex-mcp-server --sse

利用可能なツール

コアメッセージング

• create_message - ルームにメッセージを送信する
• list_messages - メッセージ履歴を取得する
• edit_message - 既存のメッセージを編集する
• delete_message - メッセージを削除する
• get_message_details - 特定のメッセージ情報を取得する

ルーム管理

• create_room - 新しいWebexスペースを作成する
• list_rooms - 利用可能なルームを閲覧する
• get_room_details - ルーム情報を取得する
• update_room - ルーム設定を変更する
• delete_room - ルームを削除する

チーム操作

• create_team - チームを作成する
• list_teams - チームを閲覧する
• get_team_details - チーム情報を取得する
• update_team - チーム設定を変更する
• delete_team - チームを削除する

メンバーシップ管理

• create_membership - ルームにユーザーを追加する
• list_memberships - ルームメンバーを表示する
• update_membership - メンバーの役割を変更する
• delete_membership - メンバーを削除する
• create_team_membership - チームメンバーを追加する
• list_team_memberships - チームメンバーを表示する

ユーザーとディレクトリ

• get_my_own_details - あなたのプロファイルを取得する
• list_people - ユーザーを検索する
• get_person_details - ユーザー情報を取得する
• create_person - 新しいユーザーを追加する (管理者のみ)
• update_person - ユーザー詳細を変更する
• delete_person - ユーザーを削除する (管理者のみ)

Webhookとイベント

• create_webhook - イベント通知を設定する
• list_webhooks - Webhookを管理する
• get_webhook_details - Webhook情報を取得する
• update_webhook - Webhookを変更する
• delete_webhook - Webhookを削除する
• list_events - アクティビティログを取得する
• get_event_details - 特定のイベント情報を取得する

エンタープライズ機能

• create_room_tab - ルームにタブを追加する
• list_room_tabs - ルームタブを表示する
• get_room_tab_details - タブ情報を取得する
• update_room_tab - タブを変更する
• delete_room_tab - タブを削除する
• create_attachment_action - フォーム送信を処理する
• get_attachment_action_details - 添付ファイルの詳細を取得する
• list_ecm_folder - エンタープライズコンテンツ管理
• get_ecm_folder_details - ECMフォルダの詳細を取得する
• create_ecm_folder - ECM構成を作成する
• update_ecm_linked_folder - ECMフォルダを変更する
• unlink_ecm_linked_folder - ECMリンクを削除する

開発

プロジェクト構造

├── lib/
│   ├── tools.js           # ツールの探索と読み込み
│   └── webex-config.js    # 集中管理されたAPI構成
├── tools/
│   └── webex-public-workspace/webex-messaging/
│       ├── create-a-message.js
│       ├── list-messages.js
│       └── ... (50以上のツール)
├── scripts/
│   └── update-webex-tools.js  # 自動ツール更新
├── mcpServer.js           # メインのMCPサーバー
├── index.js              # CLIインターフェイス
├── Dockerfile             # コンテナ構成
└── docker-compose.yml    # マルチコンテナ設定

新しいツールの追加

1. tools/webex-public-workspace/webex-messaging/ に新しいツールファイルを作成します
2. 既存のツールのパターンに従い、適切なインポートを行います
3. ツールのパスを tools/paths.js に追加します
4. node index.js tools でテストします

セキュリティ

• 非ルートコンテナ: ユーザー mcp (UID 1001) として実行されます
• マルチステージビルド: 最適化された本番用イメージ
• 環境分離: シークレットは環境変数を介して渡されます
• ヘルスチェック: コンテナモニタリングをサポート

テスト

🧪 包括的なテストスイート

• 53のテストスイートにわたる118の単体テスト
• 包括的なカバレッジで100%の合格率
• エンドツーエンドでテストされた50以上のAPIエンドポイント
• 検証された20以上の重大なバグ修正

# すべてのテストを実行します
npm test

# カバレッジを伴って実行します
npm run test:coverage

# コード品質とテストを検証します
npm run validate

🔒 コミット前の品質ゲート

Huskyのコミット前フックを使用した自動品質保証:

# gitコミット時に自動的に実行されます:
🚀 コミット前の検証を実行中...
🔍 コード品質をチェックし、118の単体テストを実行中...
✅ すべての検証が通過しました！コミットを続行します...

検証内容:

• JavaScript構文チェック
• 118の単体テストすべてが通過する必要があります
• コード品質基準
• API実装の正確性

詳細なテストドキュメントについては tests/README.md を参照してください。

コントリビュート

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更を加えます
4. コミット時に自動的にテストが実行されます コミット前フックを介して
5. 118のテストすべてが通過することを確認します
6. プルリクエストを送信します

📄 ライセンス

MITライセンス - 詳細についてはLICENSEファイルを参照してください

サポート

• 問題報告: GitHubのIssuesを通じてバグや機能要求を報告してください
• ドキュメント: 詳細なセットアップ手順についてはSETUP-COMPLETE.mdを参照してください
• コミュニティ: MCPコミュニティチャンネルで議論に参加してください