Teams MCP

🚀 Teams MCP

Teams MCP 是一個模型上下文協議（MCP）服務器，它能與 Microsoft Graph API 實現無縫集成，讓 AI 助手可以與 Microsoft Teams、用戶以及組織數據進行交互。

🚀 快速開始

若要在 Cursor/Claude/VS Code 中使用此 MCP 服務器，請添加以下配置：

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

✨ 主要特性

🔐 身份驗證

• 支持與 Microsoft Graph 的 OAuth 2.0 身份驗證流程。
• 提供安全的令牌管理和刷新功能。
• 可進行身份驗證狀態檢查。

👥 用戶管理

• 獲取當前用戶信息。
• 按姓名或電子郵件搜索用戶。
• 檢索詳細的用戶資料。
• 訪問組織目錄數據。

🏢 Microsoft Teams 集成

團隊管理

• 列出用戶加入的團隊。
• 訪問團隊詳細信息和元數據。

頻道操作

• 列出團隊內的頻道。
• 檢索頻道消息。
• 向團隊頻道發送消息。
• 支持消息重要級別（普通、高、緊急）。

團隊成員

• 列出團隊成員及其角色。
• 訪問成員信息。

💬 聊天與消息

一對一和群組聊天

• 列出用戶的聊天記錄。
• 創建新的一對一或群組對話。
• 通過過濾和分頁檢索聊天消息歷史記錄。
• 向現有聊天發送消息。

🔍 高級搜索與發現

消息搜索

• 使用 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）。
• 跨站腳本攻擊預防：自動清理內容以防止跨站腳本攻擊。

支持的 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 - 列出用戶的聊天記錄（一對一和群組）
• get_chat_messages - 通過分頁和過濾從特定聊天中檢索消息
• send_chat_message - 向聊天發送消息
• create_chat - 創建新的一對一或群組聊天

搜索操作

• 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 服務器旨在通過模型上下文協議與 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 文檔。
• 確保正確配置了身份驗證和權限。