← 返回目录

Teams MCP

社区

为AI助手提供全面的Microsoft Teams和Graph API访问能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 团队协作第 29 / 55
Stars: ★ 145 热门
传输方式: stdio（本地进程）
运行环境: Node.js 18+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 14 天前
工具数: 26

53FMRS · D

这是一个功能丰富的MCP服务器，提供了与Microsoft Teams和Graph API的广泛集成，包括消息、用户、文件和搜索。它需要适当的认证和权限配置，适合需要自动化Teams操作的开发者。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

12/20

维护活跃度

10/20

文档质量

11/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: 从README看，项目声明支持MCP初始化与工具列举，并提供了测试和CI（codecov徽章），但静态审查无法验证实际运行行为。工具列表与文档一致，但未提供可执行的验证证据，因此可靠性评分不超过12。
安全与权限 12/20: 项目支持只读模式、最小权限范围、AUTH_TOKEN校验和Markdown消毒，但删除操作（软删除）需要确认，且没有明确的数据流声明和外部网络披露。因此评分为12。
维护活跃度 10/20: 项目有MIT许可证，活跃维护（提交、问题响应），但版本控制和安全响应渠道未详细说明。因此评分为10。
文档质量 11/20: 文档详细、安装和示例齐全，但存在重复内容且未明确限制和故障排查。因此评分为11。
安装易用性 12/20: 安装步骤清晰，支持npx和配置示例，但需要手动认证和依赖Node 18，且未提供可验证的执行证据。因此评分为12。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

需要在Teams环境中自动化协作任务的开发者
希望将Teams集成到AI驱动的生产力工具中的团队
需要程序化访问Microsoft Graph数据的应用

不适合谁

需要实时通知或推送功能的场景（服务器不提供此类支持）
没有Microsoft 365账户或Graph权限的用户
需要本地部署或自定义认证流程的严格环境

所需权限

User.Read
User.ReadBasic.All
Team.ReadBasic.All
Channel.ReadBasic.All
ChannelMessage.Read.All
ChannelMessage.Send
ChannelMessage.ReadWrite
Chat.Read
Chat.ReadWrite
TeamMember.Read.All
Files.ReadWrite.All

风险与副作用

认证令牌存储在本地文件，可能被未授权访问
拥有完整写入权限可能误发或删除重要消息
文件上传和下载可能涉及敏感数据泄露
AUTH_TOKEN 直接注入可能被泄露

安装接入

准备工作

运行环境：Node.js 18+

AUTH_TOKEN 可选密钥可选的预颁发 Microsoft Graph 访问令牌（JWT），必须以 https://graph.microsoft.com 为目标；可从你现有的 OAuth 流程获取。

其他可选配置项（1 个）

TEAMS_MCP_READ_ONLY 可选设为 true 时服务器以只读模式启动，禁用所有写操作工具并只请求读取权限范围；可自行设置。

确保已安装 Node.js 18+ 和 Microsoft 365 账户。
在 Cursor/Claude/VS Code 的 MCP 配置文件中添加上述 JSON 配置。
运行 npx @floriscornel/teams-mcp@latest authenticate 进行认证。
或者，设置环境变量 AUTH_TOKEN 为有效的 Microsoft Graph JWT。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add teams-mcp -- npx -y @floriscornel/teams-mcp@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

先运行 npx @floriscornel/teams-mcp@latest authenticate 完成授权，然后在客户端工具列表中确认出现 auth_status、get_current_user 等工具，调用 get_current_user 能返回当前登录的 Microsoft 365 用户信息即说明连接成功。

常见排障

认证失败：运行 `npx @floriscornel/teams-mcp@latest check` 检查状态，重新运行 authenticate。
消息发送失败：确保应用已授予所需的Graph权限，并检查token是否过期。
文件上传错误：确认文件路径存在，且具有正确的读写权限。
连接问题：确保客户端配置中命令和参数正确，且网络可以访问Microsoft Graph。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我加入的所有 Teams 团队和频道
搜索上周讨论项目进度并且 @提到我的消息
把这份 /path/to/report.pdf 发送到我们的团队频道，附上一句话说明
帮我创建一个和 alex.chen 的 1:1 聊天并发送一条 Markdown 格式的问候

工具能力 26

auth_status 只读

检查当前认证状态。

get_current_user 只读

获取当前已认证用户的信息。

search_users 只读

按名称或电子邮件搜索用户。

get_user 只读

按ID或电子邮件获取详细用户信息。

list_teams 只读

列出用户加入的团队。

list_channels 只读

列出指定团队中的频道。

get_channel_messages 只读

获取团队频道的消息，支持附件摘要和内容格式选择。

get_channel_message_replies 只读

获取特定频道消息的回复。

展开其余 18 个工具

send_channel_message 写入

向团队频道发送消息，支持提及、重要性和图片附件。

reply_to_channel_message 写入

回复现有的频道消息。

update_channel_message 写入

编辑之前发送的频道消息或回复。

delete_channel_message 破坏性

软删除频道消息或回复。

list_team_members 只读

列出特定团队的成员。

search_users_for_mentions 只读

搜索团队成员以在消息中提及。

send_file_to_channel 写入

上传本地文件并将其作为消息发送到频道。

list_chats 只读

列出用户的聊天（1对1和群聊）。

get_chat_messages 只读

获取特定聊天的消息，支持分页、过滤、排序和fetchAll。

send_chat_message 写入

向聊天发送消息。

create_chat 写入

创建新的1对1或群聊。

update_chat_message 写入

编辑之前发送的聊天消息。

delete_chat_message 破坏性

软删除聊天消息。

send_file_to_chat 写入

上传本地文件并将其作为消息发送到聊天。

download_message_hosted_content 只读

从频道消息下载托管内容（图片、文件）。

download_chat_hosted_content 只读

从聊天消息下载托管内容（图片、文件）。

search_messages 只读

使用KQL语法在所有Teams消息中搜索。

get_my_mentions 只读

查找提及当前用户的最近消息。

使用场景

通过AI助手发送和接收Teams消息

搜索用户和组织目录

上传和下载文件附件

在频道和聊天中管理消息（编辑、删除）

支持客户端

Claude Desktop

Cursor

VS Code

依据项目文档列出，未经本站实测。

详细介绍

Teams MCP 是一个Model Context Protocol (MCP) 服务器，用于通过 Microsoft Graph API 与 Microsoft Teams、用户、聊天、文件和组织数据进行交互。它支持 OAuth 2.0 设备代码认证、只读模式、消息搜索、富文本格式（Markdown/HTML）以及附件上传和下载。