MCP Teams Server

Name: MCP Teams Server
Author: InditexTech

本地服务

github.com/InditexTech通信协作4511 周前更新

代码仓库

关于 MCP Teams Server

MCP Teams Server 是面向 Microsoft Teams 集成的 MCP 服务，可读取和发送频道消息、回复线程并提及成员。适合需要让 AI 助手与 Teams 协作的团队。

主要功能

01在频道中创建带标题和内容的线程
02回复已有线程并提及用户
03读取线程回复和频道消息
04列出频道团队成员
05支持 stdio、streamable-http 与 sse 传输

适用场景

01让 AI 助手读取 Teams 频道消息并总结讨论
02通过 AI 助手在频道中发起线程并提醒成员

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露读取消息、发送消息、回复线程和提及成员等能力。默认使用 stdio 传输，也可通过 streamable-http 部署。

#mcp #msteams #inditex #mcp-server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "teams-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TEAMS_APP_ID",
        "-e",
        "TEAMS_APP_PASSWORD",
        "-e",
        "TEAMS_APP_TYPE",
        "-e",
        "TEAMS_APP_TENANT_ID",
        "-e",
        "TEAM_ID",
        "-e",
        "TEAMS_CHANNEL_ID",
        "-e",
        "DOCKER_HOST",
        "ghcr.io/inditextech/mcp-teams-server"
      ],
      "env": {
        "TEAMS_APP_ID": "<TEAMS_APP_ID>",
        "TEAMS_APP_PASSWORD": "<TEAMS_APP_PASSWORD>",
        "TEAMS_APP_TYPE": "<TEAMS_APP_TYPE>",
        "TEAMS_APP_TENANT_ID": "<TEAMS_APP_TENANT_ID>",
        "TEAM_ID": "<TEAM_ID>",
        "TEAMS_CHANNEL_ID": "<TEAMS_CHANNEL_ID>",
        "DOCKER_HOST": "<DOCKER_HOST>"
      }
    }
  }
}

启动命令

docker run -i --rm -e TEAMS_APP_ID -e TEAMS_APP_PASSWORD -e TEAMS_APP_TYPE -e TEAMS_APP_TENANT_ID -e TEAM_ID -e TEAMS_CHANNEL_ID -e DOCKER_HOST ghcr.io/inditextech/mcp-teams-server

需要配置的环境变量

TEAMS_APP_ID

TEAMS_APP_PASSWORD密钥

TEAMS_APP_TYPE

TEAMS_APP_TENANT_ID

TEAM_ID

TEAMS_CHANNEL_ID

DOCKER_HOST

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

ocighcr.io/inditextech/mcp-teams-serverstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

GitHub License GitHub Release

MCP Teams 服务

一个用于集成 Microsoft Teams 的 MCP（模型上下文协议）服务，可读取消息、创建消息、回复消息以及提及成员。

功能

https://github.com/user-attachments/assets/548a9768-1119-4a2d-bd5c-6b41069fc522

在频道中创建包含标题和内容的讨论串，并提及用户
通过消息回复更新现有讨论串，并提及用户
读取讨论串回复
列出频道团队成员
读取频道消息

前提条件

uv 包管理器
Python 3.12
已完成适当配置的 Microsoft Teams 帐户

安装

克隆仓库：

git clone https://github.com/InditexTech/mcp-teams-server
cd mcp-teams-server

创建虚拟环境并安装依赖项：

uv venv
uv sync --frozen --all-extras --dev

Teams 配置

请阅读此文档，了解如何配置 Microsoft Teams 和所需的 Azure 资源。本文档并非逐步指南，但可以帮助你了解所需内容。

使用方法

在 shell 中或 .env 文件中设置以下环境变量。你可以将示例文件用作模板：

Key	Description
TEAMS_APP_ID	MS Entra ID 应用程序 ID 的 UUID
TEAMS_APP_PASSWORD	客户端密钥
TEAMS_APP_TENANT_ID	SingleTenant 情况下的租户 uuid
TEAM_ID	MS Teams 群组 ID 或团队 ID
TEAMS_CHANNEL_ID	MS Teams 频道 ID，包含经过 URL 转义的字符

启动服务：

uv run mcp-teams-server

默认 MCP 传输方式为 stdio。也可以在 HTTP 部署中使用 streamable-http：

uv run mcp-teams-server --transport streamable-http

旧版 sse 传输方式仍可供较旧的客户端使用。

开发

集成测试需要设置以下环境变量：

Key	Description
TEST_THREAD_ID	讨论串 ID 的时间戳
TEST_MESSAGE_ID	消息 ID 的时间戳
TEST_USER_NAME	测试用户名

uv run pytest -m integration

预构建 Docker 镜像

ghcr.io 上托管了一个预构建镜像。你可以运行以下命令安装此镜像：

docker pull ghcr.io/inditextech/mcp-teams-server:latest

构建 Docker 镜像

你可以使用 Docker 镜像运行 MCP 服务。运行以下命令即可构建镜像：

docker build . -t inditextech/mcp-teams-server

运行 Docker 镜像

基本运行配置：

docker run -it inditextech/mcp-teams-server

使用 .env 文件中的环境变量运行：

docker run --env-file .env -it inditextech/mcp-teams-server

使用 Streamable HTTP 传输方式运行：

docker run --env-file .env -p 8000:8000 -it inditextech/mcp-teams-server --transport streamable-http

设置 LLM 以使用 MCP Teams Server

请按照以下文档中的说明操作。

更新日志

请参阅 CHANGELOG.md，了解更改列表和版本历史记录。

贡献

请阅读 CONTRIBUTING.md，了解我们的行为准则以及提交拉取请求的流程。

安全

如有安全方面的问题，请参阅我们的安全政策。

许可证

本项目采用 Apache-2.0 许可证，详情请参阅该文件。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。