MCP Teams Server

一个用于 Microsoft Teams 集成的 MCP (Model Context Protocol) 服务器实现，提供读取消息、创建消息、回复消息、提及成员的功能。

功能

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

• 在频道中启动带有标题和内容的线程，并提及用户
• 使用消息回复更新现有线程，并提及用户
• 读取线程回复
• 列出频道团队成员
• 读取频道消息

前提条件

• uv 包管理器
• Python 3.10
• 具有正确设置的 Microsoft Teams 帐户

安装

1. 克隆存储库：

git clone [repository-url]
cd mcp-teams-server

2. 创建一个虚拟环境并安装依赖项：

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_TYPE	SingleTenant 或 MultiTenant
TEAMS_APP_TENANT_ID	SingleTenant 情况下的租户 UUID
TEAM_ID	MS Teams 群组 ID 或团队 ID
TEAMS_CHANNEL_ID	带有 URL 转义字符的 MS Teams 频道 ID

启动服务器：

uv run mcp-teams-server

开发

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

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

设置 LLM 以使用 MCP Teams Server

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

更新日志

有关更改和版本历史的列表，请参见 CHANGELOG.md。

贡献

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

安全

有关安全问题，请参阅我们的 安全策略。

许可证

该项目已获得 Apache-2.0 许可，详细信息请参见文件。

© 2025 INDUSTRIA DE DISEÑO TEXTIL S.A. (INDITEX S.A.)