Teams MCP

🚀 Teams MCP

A Model Context Protocol (MCP)サーバーです。Microsoft Graph APIとのシームレスな統合を提供し、AIアシスタントがMicrosoft Teams、ユーザー、および組織データとやり取りできるようにします。

🚀 クイックスタート

このMCPサーバーをCursor/Claude/VS Codeで使用するには、以下の設定を追加します。

{
  "mcpServers": {
    "teams-mcp": {
      "command": "npx",
      "args": ["-y", "@floriscornel/teams-mcp@latest"]
    }
  }
}

✨ 主な機能

🔐 認証

• Microsoft GraphとのOAuth 2.0認証フロー
• セキュアなトークン管理とリフレッシュ
• 認証ステータスのチェック

👥 ユーザー管理

• 現在のユーザー情報を取得
• 名前またはメールアドレスでユーザーを検索
• 詳細なユーザープロファイルを取得
• 組織ディレクトリデータにアクセス

🏢 Microsoft Teams統合

• Teams管理
  • ユーザーが参加しているチームを一覧表示
  • チームの詳細とメタデータにアクセス
• チャネル操作
  • チーム内のチャネルを一覧表示
  • チャネルのメッセージを取得
  • チームチャネルにメッセージを送信
  • メッセージの重要度レベル（通常、高、緊急）をサポート
• チームメンバー
  • チームメンバーとその役割を一覧表示
  • メンバー情報にアクセス

💬 チャットとメッセージング

• 1対1およびグループチャット
  • ユーザーのチャットを一覧表示
  • 新しい1対1またはグループ会話を作成
  • フィルタリングとページネーションを使用してチャットメッセージ履歴を取得
  • 既存のチャットにメッセージを送信

🔍 高度な検索と発見

• メッセージ検索
  • Microsoft Search APIを使用してすべてのTeamsチャネルとチャットを検索
  • KQL（キーワードクエリ言語）構文をサポート
  • 送信者、メンション、添付ファイル、重要度、および日付範囲でフィルタリング
  • 高度なフィルタリングオプションで最近のメッセージを取得
  • 特定のユーザーをメンションしているメッセージを検索

リッチメッセージフォーマットのサポート

以下のツールは、Teamsチャネルとチャットでのリッチメッセージフォーマットをサポートしています。

• send_channel_message
• send_chat_message
• reply_to_channel_message

フォーマットオプション

メッセージのフォーマットを制御するために、formatパラメータを指定できます。

• text（デフォルト）: プレーンテキスト
• markdown: Markdownフォーマット（太字、斜体、リスト、リンク、コードなど） - サニタイズされたHTMLに変換

formatがmarkdownに設定されている場合、メッセージ内容は安全なMarkdownパーサーを使用してHTMLに変換され、潜在的に危険なコンテンツが削除された後、Teamsに送信されます。 formatが指定されていない場合、メッセージはプレーンテキストとして送信されます。

例

{
  "teamId": "...",
  "channelId": "...",
  "message": "**Bold text** and _italic text_\n\n- List item 1\n- List item 2\n\n[Link](https://example.com)",
  "format": "markdown"
}

{
  "chatId": "...",
  "message": "Simple plain text message",
  "format": "text"
}

セキュリティ機能

• HTMLサニタイズ: すべてのMarkdownコンテンツはHTMLに変換され、潜在的に危険な要素（スクリプト、イベントハンドラーなど）が削除されます。
• 許可されたタグ: 安全なHTMLタグのみが許可されます（p、strong、em、a、ul、ol、li、h1 - h6、code、preなど）。
• 安全な属性: 安全な属性のみが許可されます（href、target、src、alt、title、width、height）。
• XSS防止: コンテンツは自動的にサニタイズされ、クロスサイトスクリプティング攻撃を防止します。

サポートされるMarkdown機能

• テキストフォーマット: 太字 (**text**)、斜体 (_text_)、取り消し線 (~~text~~)
• リンク: [text](url)
• リスト: 箇条書き (- item) と番号付き (1. item)
• コード: インライン `code` とブロック code
• 見出し: # H1 から ###### H6
• 改行: 改行は自動的に <br> タグに変換されます。
• 引用: > quoted text
• テーブル: GitHubフレーバーのMarkdownテーブル

📦 インストール

# 依存関係のインストール
npm install

# プロジェクトのビルド
npm run build

# 認証の設定
npm run auth

🔧 技術詳細

前提条件

• Node.js 18+
• 適切な権限を持つMicrosoft 365アカウント
• Microsoft Graphの権限を持つAzureアプリ登録

必要なMicrosoft Graphの権限

• User.Read - ユーザープロファイルを読み取る
• User.ReadBasic.All - 基本的なユーザー情報を読み取る
• Team.ReadBasic.All - チーム情報を読み取る
• Channel.ReadBasic.All - チャネル情報を読み取る
• ChannelMessage.Read.All - チャネルメッセージを読み取る
• ChannelMessage.Send - チャネルメッセージを送信する
• Chat.Read - チャットメッセージを読み取る
• Chat.ReadWrite - チャットを作成および管理する
• Mail.Read - Microsoft Search APIに必要
• Calendars.Read - Microsoft Search APIに必要
• Files.Read.All - Microsoft Search APIに必要
• Sites.Read.All - Microsoft Search APIに必要

🛠️ 使用例

サーバーの起動

# ホットリロード付きの開発モード
npm run dev

# 本番モード
npm run build && node dist/index.js

利用可能なMCPツール

認証

• authenticate - OAuth認証フローを開始
• logout - 認証トークンをクリア
• get_current_user - 認証されたユーザー情報を取得

ユーザー操作

• search_users - 名前またはメールアドレスでユーザーを検索
• get_user - IDまたはメールアドレスで詳細なユーザー情報を取得

チーム操作

• list_teams - ユーザーが参加しているチームを一覧表示
• list_channels - 特定のチーム内のチャネルを一覧表示
• get_channel_messages - ページネーションとフィルタリングを使用してチームチャネルからメッセージを取得
• send_channel_message - チームチャネルにメッセージを送信
• list_team_members - 特定のチームのメンバーを一覧表示

チャット操作

• list_chats - ユーザーのチャット（1対1およびグループ）を一覧表示
• get_chat_messages - ページネーションとフィルタリングを使用して特定のチャットからメッセージを取得
• send_chat_message - チャットにメッセージを送信
• create_chat - 新しい1対1またはグループチャットを作成

検索操作

• search_messages - KQL構文を使用してすべてのTeamsメッセージを検索
• get_recent_messages - 高度なフィルタリングオプションで最近のメッセージを取得
• get_my_mentions - 現在のユーザーをメンションしているメッセージを検索

📋 具体例

認証

まず、Microsoft Graphで認証します。

npx @floriscornel/teams-mcp@latest authenticate

認証ステータスを確認します。

npx @floriscornel/teams-mcp@latest check

必要に応じてログアウトします。

npx @floriscornel/teams-mcp@latest logout

Cursor/Claudeとの統合

このMCPサーバーは、Model Context Protocolを通じてClaude/Cursor/VS CodeなどのAIアシスタントと連携するように設計されています。

{
  "mcpServers": {
    "teams-mcp": {
      "command": "npx",
      "args": ["-y", "@floriscornel/teams-mcp@latest"]
    }
  }
}

🔒 セキュリティ

• すべての認証はMicrosoftのOAuth 2.0フローを通じて処理されます。
• トークンは安全に保存され、自動的にリフレッシュされます。
• 機密データはログに記録されたり公開されたりすることはありません。
• Microsoft Graph APIのセキュリティベストプラクティスに従っています。

📄 ライセンス

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

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. リントとフォーマットを実行します。
5. プルリクエストを送信します。

📞 サポート

問題や質問については、以下を確認してください。

• 既存のGitHubの問題を確認する
• Microsoft Graph APIのドキュメントを確認する
• 適切な認証と権限が設定されていることを確認する