Cisco Webex MCP Server

Webex MCP サーバー

AI アシスタントに Cisco Webex のメッセージング機能への包括的なアクセスを提供する Model Context Protocol（MCP）サーバーです。

ビジネスの目的から Webex の操作へ

AI エージェントは、このサーバーをコラボレーションのアクションレイヤーとして利用できます。ビジネス目標を一連の Webex 操作に変換し、関連する機能を選択して、ワークフローを最後まで実行します。顧客への通知、インシデント対応ルームの作成、顧客チームやスペースの維持管理、ユーザーとメンバーシップの管理、Webex イベントへの対応、エンタープライズコンテンツや承認のやり取りとの連携などが可能です。

このサーバーは、メッセージ、ルーム、チーム、メンバーシップ、ユーザー、Webhook、イベント、タブ、添付ファイルの操作、ECM フォルダーをコンポーザブルな MCP ツールとして公開します。そのため、エージェントはハードコードされた単一の自動化に限定されず、ビジネスニーズに合わせてワークフローを構築できます。

▶ 音声付きの15秒解説動画を見る

Claude または Codex で公開準備が整ったメディアを作成する

この解説動画は、平易な言葉でのリクエストから Agentic Media Harness を使って作成されました。その agentic-media プラグインは、Claude Code または Codex を本格的なメディア制作ワークフローへと変えます。リポジトリを読み取り、プロンプトを改善し、画像や動画を生成し、動きとスクリプトの正確さを確認し、品質を高めるために繰り返し調整し、すべてのプロンプト、スコア、費用を記録します。

プラグインを一度インストールすれば、コーディングエージェントを離れることなく、リポジトリの内容を反映した製品動画、ヒーロー画像、インフォグラフィック、ローンチ素材を作成できます。

Claude Code

pip install "git+ssh://[email protected]/Kashyap-AI-ML-Solutions/agentic-media-harness.git#subdirectory=packages/amh"
claude plugin marketplace add Kashyap-AI-ML-Solutions/agentic-media-harness
claude plugin install agentic-media@agentic-media-harness
export GEMINI_API_KEY=your_key_here   # create + enable billing: https://aistudio.google.com/apikey

Codex CLI

pip install "git+ssh://[email protected]/Kashyap-AI-ML-Solutions/agentic-media-harness.git#subdirectory=packages/amh"
codex plugin marketplace add Kashyap-AI-ML-Solutions/agentic-media-harness
codex plugin add agentic-media@agentic-media-harness
export GEMINI_API_KEY=your_key_here   # optional for images; required for video

代わりに、リポジトリの .env ファイルに GEMINI_API_KEY=your_key を記述することもできます。このファイルは絶対にコミットしないでください。

任意のリポジトリを開いて、次のように依頼してください。

media-video スキルを使って、このリポジトリの短い解説動画を作成してください。まず README を読んでください。予算は $2.50 です。

概要

この MCP サーバーを使用すると、52 種類のツールを通じて AI アシスタントが Webex メッセージングを利用できます。主な機能は次のとおりです。

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

特長

• ✅ Webex API を包括的にカバー：主要なメッセージング操作を網羅する 52 種類のツール
• ✅ Docker に対応：本番環境向けのコンテナ化
• ✅ デュアルトランスポート：STDIO と HTTP（StreamableHTTP）の両方のモードに対応
• ✅ エンタープライズ対応：Cisco のエンタープライズ認証に対応
• ✅ 型安全：適切なエラー処理を備えた TypeScript／JavaScript の完全な実装
• ✅ 一元化された設定：トークンとエンドポイントを簡単に管理

クイックスタート

前提条件

• Node.js 18 以降（20 以降を推奨）。警告：低いバージョンの Node で実行すると、fetch が使用できません。ツールは HTTP 呼び出しに fetch を使用します。回避するには、ツールを変更して代わりに node-fetch を使用してください。その際、node-fetch が依存関係としてインストールされていることを確認し、各ツールファイルで fetch としてインポートしてください。
• Docker（任意。コンテナ化してデプロイする場合）
• developer.webex.com から取得した Webex API トークン

トークンの更新

Webex の Bearer トークンは有効期間が短く、現在のトークンは 12 時間で期限切れになります。更新するには：

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

インストール

1. クローンして依存関係をインストールします：

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

2. 環境を設定します：

   cp .env.example .env
   # Edit .env with your Webex API token
   

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

   # List available tools
   node index.js tools
   
   # Discover tools with detailed analysis
   npm run discover-tools
   
   # Start MCP server (STDIO mode - default)
   node mcpServer.js
   
   # Start MCP server (HTTP mode)
   npm run start:http
   

🔍 ツールの検出

このサーバーには、包括的なツール検出機能が含まれています。

ツール検出コマンド

# Human-readable tool analysis
npm run discover-tools

# JSON output for programmatic use
npm run discover-tools -- --json

# Filter tools by category
ENABLED_TOOLS=create_message,list_rooms npm run discover-tools

# Get help
npm run discover-tools -- --help

ツールマニフェスト

tools-manifest.json ファイルには、次の情報が記載されています。

• ツールカテゴリ：メッセージ、ルーム、チーム、メンバーシップ、ユーザー、ウェブフック、エンタープライズ
• 全 52 種類のツール：Webex メッセージング API を包括的にカバー
• 環境設定：必須および任意の変数
• テスト情報：カバレッジと検証の詳細
• 移行履歴：MCP プロトコルのアップグレードに関するドキュメント

ツールの構成

ツールは機能別に構成されています。

• メッセージ（6 種類）：メッセージの作成、一覧表示、編集、削除
• ルーム（6 種類）：ルームの管理と設定
• チーム（5 種類）：チームの作成と管理
• メンバーシップ（10 種類）：ルームおよびチームのメンバーシップ操作
• ユーザー（6 種類）：ユーザープロフィールとディレクトリの管理
• ウェブフック（7 種類）：イベント通知とウェブフックの管理
• エンタープライズ（12 種類）：ECM フォルダー、ルームタブ、添付ファイル

ツール選択と動作のメタデータ

全 52 種類のツールは、MCP アノテーションに加え、tools/list を通じて簡潔な選択ガイダンスと動作ガイダンスを公開します。元の目的文と入力スキーマは変更されません。追加されるガイダンスでは、最も近い関連ツール、操作が Webex の状態を読み取るものか変更するものか、API エラーとレート制限がどのように返されるかを示します。

アノテーションは MCP クライアント向けの説明的なヒントであり、認可の制御には使用されません。引き続き、Webex アクセストークンと組織のポリシーが優先されます。

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_PUBLIC_WORKSPACE_API_KEY	はい	Webex API トークン（「Bearer 」プレフィックスなし）	-
WEBEX_API_BASE_URL	いいえ	Webex API のベース URL	https://webexapis.com/v1
WEBEX_USER_EMAIL	いいえ	Webex のメールアドレス（参照用）	-
PORT	いいえ	HTTP モードのポート	3001
MCP_MODE	いいえ	トランスポートモード（stdio または http）	stdio

Webex API トークンの取得

1. developer.webex.com にアクセスします
2. Cisco／Webex アカウントでサインインします
3. API ドキュメントからベアラートークンをコピーします
4. 重要：.env ファイルに追加する際は、「Bearer 」プレフィックスを削除してください

MCP クライアントとの統合

Claude Desktop（STDIO モード）

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": "[email protected]",
        "WEBEX_API_BASE_URL": "https://webexapis.com/v1",
        "WEBEX_PUBLIC_WORKSPACE_API_KEY": "your_token_here"
      }
    }
  }
}

HTTP モードとの統合

HTTP ベースの MCP クライアントでは、サーバーを HTTP モードで起動します：

# Start HTTP server
npm run start:http

# Server endpoints:
# Health check: http://localhost:3001/health
# MCP endpoint: http://localhost:3001/mcp

サーバーは StreamableHTTP トランスポートを使用する MCP 2025-11-25 プロトコルをサポートしており、以下が含まれます：

• mcp-session-id ヘッダーの公開を含む適切な CORS 設定
• ステートフル接続のためのセッション管理
• Server-Sent Events（SSE）レスポンス形式

その他の MCP クライアント

STDIO モードの場合：

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

HTTP モードの場合：

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

利用可能なツール

メッセージングの基本機能

• 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 リンクを削除します

トランスポートモード

STDIO モード（デフォルト）

Claude Desktop などの MCP クライアントのデフォルトのトランスポートモードです：

# Start in STDIO mode
node mcpServer.js
# or
npm start

HTTP モード（StreamableHTTP）

MCP 2025-11-25 プロトコルに対応した、HTTP ベースのトランスポートです。

# Start in HTTP mode
npm run start:http
# or
node mcpServer.js --http

HTTP モードの機能：

• ヘルスチェック：GET http://localhost:3001/health
• MCP エンドポイント：POST http://localhost:3001/mcp
• セッション管理：セッション ID を自動的に処理します
• CORS サポート：適切なクロスオリジン設定
• プロトコル：StreamableHTTP トランスポートを使用する MCP 2025-11-25

環境変数：

• MCP_MODE=http - HTTP モードを強制します
• PORT=3001 - カスタムポート（デフォルト：3001）

Smithery との統合

このサーバーは、HTTP ランタイムを使用して Smithery 経由で自動デプロイできるように設定されています。

# smithery.yaml
runtime: "nodejs"
main: "mcpServer.js"
envMapping:
  webexApiKey: "WEBEX_PUBLIC_WORKSPACE_API_KEY"
  webexApiBaseUrl: "WEBEX_API_BASE_URL"

次のコマンドでデプロイします：smithery deploy

開発

プロジェクト構成

├── lib/
│   ├── tools.js           # Tool discovery and loading
│   └── webex-config.js    # Centralized API configuration
├── tools/
│   └── webex-public-workspace/webex-messaging/
│       ├── create-a-message.js
│       ├── list-messages.js
│       └── ... (50 more tools)
├── scripts/
│   └── update-webex-tools.js  # Automated tool updates
├── mcpServer.js           # Main MCP server
├── index.js              # CLI interface
├── Dockerfile             # Container configuration
└── docker-compose.yml    # Multi-container setup

新しいツールの追加

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

セキュリティ

• 非 root コンテナ：ユーザー mcp（UID 1001）として実行します
• マルチステージビルド：本番用イメージを最適化します
• 環境の分離：シークレットは環境変数経由で渡されます
• ヘルスチェック：コンテナの監視をサポートします

テスト

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

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

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run tests locally (same as npm test)
npm run test:local

# Validate code quality + tests
npm run validate

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

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

# Automatically runs on git commit:
🚀 Running pre-commit validation...
🔍 Checking code quality and running 118 unit tests...
✅ All validations passed! Commit proceeding...

検証項目：

• JavaScript の構文チェック
• 118 件すべてのユニットテストの合格
• コード品質基準
• API 実装の正確性

テストの詳細については、tests/README.md を参照してください。

貢献

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

ライセンス

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

サポート

• 問題：GitHub のイシューからバグや機能リクエストを報告できます
• ドキュメント：詳細なセットアップ手順については、SETUP-COMPLETE.md を参照してください
• コミュニティ：MCP コミュニティのチャンネルでディスカッションに参加できます