适合谁
- 需要在Teams环境中自动化协作任务的开发者
- 希望将Teams集成到AI驱动的生产力工具中的团队
- 需要程序化访问Microsoft Graph数据的应用
T
53FMRS · D
这是一个功能丰富的MCP服务器，提供了与Microsoft Teams和Graph API的广泛集成，包括消息、用户、文件和搜索。它需要适当的认证和权限配置，适合需要自动化Teams操作的开发者。
Teams MCP 是一个Model Context Protocol (MCP) 服务器，用于通过 Microsoft Graph API 与 Microsoft Teams、用户、聊天、文件和组织数据进行交互。它支持 OAuth 2.0 设备代码认证、只读模式、消息搜索、富文本格式（Markdown/HTML）以及附件上传和下载。
工具能力
auth_status
检查当前认证状态。
get_current_user
获取当前已认证用户的信息。
search_users
按名称或电子邮件搜索用户。
get_user
按ID或电子邮件获取详细用户信息。
list_teams
列出用户加入的团队。
list_channels
列出指定团队中的频道。
get_channel_messages
获取团队频道的消息，支持附件摘要和内容格式选择。
get_channel_message_replies
获取特定频道消息的回复。
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
查找提及当前用户的最近消息。
安装接入
- 确保已安装 Node.js 18+ 和 Microsoft 365 账户。2. 在 Cursor/Claude/VS Code 的 MCP 配置文件中添加上述 JSON 配置。3. 运行
npx @floriscornel/teams-mcp@latest authenticate进行认证。4. 或者，设置环境变量AUTH_TOKEN为有效的 Microsoft Graph JWT。
claude_desktop_config.json
{
"mcpServers": {
"teams-mcp": {
"command": "npx",
"args": [
"-y",
"@floriscornel/teams-mcp@latest"
]
}
}
}
选型与风险
不适合谁
- 需要实时通知或推送功能的场景（服务器不提供此类支持）
- 没有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 直接注入可能被泄露
常见排障
- 认证失败：运行 `npx @floriscornel/teams-mcp@latest check` 检查状态，重新运行 authenticate。
- 消息发送失败：确保应用已授予所需的Graph权限，并检查token是否过期。
- 文件上传错误：确认文件路径存在，且具有正确的读写权限。
- 连接问题：确保客户端配置中命令和参数正确，且网络可以访问Microsoft Graph。
使用场景
通过AI助手发送和接收Teams消息
搜索用户和组织目录
上传和下载文件附件
在频道和聊天中管理消息（编辑、删除）
支持客户端
Claude Desktop完整支持
Cursor完整支持
VS Code完整支持