AI导哈

Teams会议管理服务器

一款通过Microsoft Graph API管理Teams会议（安排/重安排/取消）及日历事件的自动化服务器

  • by alivnavc
  • Python
  • 本地部署
  • 6 星标
  • 更新于
在 GitHub 查看 alivnavc/Microsoft-Teams-Meetings-MCP-Server

使用说明

Microsoft Teams MCP服务器

使用Microsoft Graph API计划、重新安排、取消Microsoft Teams面试和管理日历事件的服务器。

特性

  • 安排新的Microsoft Teams会议，包括与会者、主题和正文。
  • 通过更新现有会议的开始和结束时间来重新安排会议。
  • 使用会议ID取消会议。
  • 列出支持时区的团队日历事件。
  • 检索IANA支持的时区列表，以安排和过滤事件。

先决条件

  • Python 3.8或更高版本。
  • 具有Microsoft Graph API权限的Microsoft Azure AD应用程序（例如。， Calendars.ReadWrite, User.Read.All).
  • git 和 pip 安装在您的系统上。
  • （可选） uv 用于运行服务器（通过安装 pip install uv).
  • （可选） ngrok 用于使用HTTPS公开本地服务器（OpenAI API集成所需）。

安装

使用回购源代码

  1. 克隆存储库：

    git clone https://github.com/alivnavc/Microsoft-Teams-Meetings-MCP-Server.git
cd Microsoft-Teams-Meetings-MCP-Server

  2. 创建并激活虚拟环境：

    python -m venv venv
# On Unix/Linux/MacOS:
source venv/bin/activate
# On Windows (Command Prompt):
venv\Scripts\activate
# On Windows (PowerShell):
.\venv\Scripts\Activate.ps1

  3. 安装依赖项：

    pip install -r requirements.txt

  4. 配置环境变量：

    • 创建一个 .env 项目根目录中的文件。
    • 添加您的Microsoft Graph API凭据：
      MS_TENANT_ID=your_tenant_id
MS_CLIENT_ID=your_client_id
MS_CLIENT_SECRET=your_client_secret
MS_USER_ID=your_user_id

  5. 运行服务器：

    python server.py

    或者，如果使用 uv:

    uv run server.py

  6. 通过Docker部署（可选）

    使用.env文件拉取并运行Docker镜像

    docker pull alivnavc/microsoft-teams-mcp

docker run -d -p 4200:4200 --name teams-mcp-server --env-file /path/to/.env alivnavc/microsoft-teams-mcp

    --env文件/path/to/.env将环境变量从本地.env文件加载到容器中 （将/path/to/.env替换为.env文件的实际路径）

    验证容器是否正在运行

    docker ps

使用PIP

  1. pip install microsoft-teams-mcp==1.1.4
  2. 使用以下代码
    from microsoft_teams_mcp import server
server.main({
 "MS_TENANT_ID": "Tenant ID",
 "MS_CLIENT_ID": "Client ID",
 "MS_CLIENT_SECRET": "Client Secret",
 "MS_USER_ID": "User Id"
 
})

Run the command : python filename.py

Microsoft Graph API的Azure AD安装程序

若要使用Microsoft Graph API，您需要在Microsoft Azure AD中注册应用程序并配置必要的权限。遵循以下步骤（总结自 MS-Teams-setup.md):

  1. 注册Azure AD应用程序:

    • 在Azure门户中创建Microsoft Entra ID应用程序。
    • 注意应用程序UUID（设置为 MS_CLIENT_ID 在你的 .env 文件）。
    • 为单租户或多租户配置应用程序：
      • 对于单租户，将租户UUID存储在 MS_TENANT_ID 并设置 MS_APP_TYPE=SingleTenant.
      • 对于多租户，请在Azure中相应地调整设置。

  2. 添加客户端密码:

    • 为Azure AD应用程序生成客户端密钥。
    • 将秘密存储在 MS_CLIENT_SECRET 在你的 .env 文件。

  3. 配置Microsoft Graph API权限:

    • 添加 Calendars.ReadWrite 许可（以及可选 User.Read.All 用于列出事件）到Azure AD应用程序。
    • 确保权限已获得管理员同意。

  4. Azure Bot注册（可选）:

    • 如果与Microsoft Teams渠道集成，请使用相同的方式注册Azure Bot MS_CLIENT_ID.
    • 将机器人程序连接到Teams频道，并将其配置为使用Microsoft Graph API。

有关详细说明，请参阅 MS-Teams-setup.md.

用法

服务器运行在 http://localhost:4200/mcp/ 默认情况下，在本地运行时。它公开了一个用于与Microsoft团队会议和日历交互的JSON-RPC API。

重要说明

  • 微软的MCP服务器：Microsoft提供了一个MCP服务器来管理Teams会议，但发现某些工具（例如，与自定义与会者进行日程安排、重新安排、取消和支持时区的日历事件列表）缺失或不足。该项目是为了解决这些差距而开发的，提供了一个使用以下工具的定制实现。
  • 存储事件ID：使用以下命令安排会议时 schedule_teams_meeting，响应包括 event_id。将此ID存储在数据库或本地文件（例如JSON或CSV）中，因为重新安排需要它(reschedule_teams_meeting)或取消(cancel_teams_meeting)会议。例如，您可以保存 event_id 以及SQLite数据库或JSON文件中的相关元数据（例如，会议主题、日期），以便于检索。
  • OpenAI API集成：如果您计划将此服务器与OpenAI API集成，请注意，OpenAI需要HTTPS端点。本地服务器(http://localhost:4200/mcp/)不会与OpenAI合作。使用 ngrok 使用HTTPS URL公开本地服务器：
    1. 安装 ngrok （例如，通过 npm install -g ngrok 或从以下网址下载 ngrok.com).
    2. 运行：
      ngrok http 4200
      以生成HTTPS URL（例如。， https://your-ngrok-subdomain.ngrok.io).
    3. 使用ngrok URL（例如。， https://your-ngrok-subdomain.ngrok.io/mcp/)作为OpenAI API集成的端点。

在服务器上部署

  1. 在服务器上部署应用程序（例如AWS EC2、Azure VM）。
  2. 将客户端中的服务器URL更新为服务器的公共IP或域（例如。， http://your-server-ip:4200/mcp/).
  3. 确保使用Nginx等反向代理为生产启用HTTPS。
  4. 使用环境变量保护敏感数据（例如API证书）。

API使用

服务器使用 FastMCP 该框架公开JSON-RPC端点，用于管理Microsoft Teams会议和日历。下面是可用的工具、它们的功能以及如何将它们与示例JSON-RPC有效载荷一起使用。

1. schedule_teams_meeting

描述：使用指定主题、开始/结束时间（UTC，ISO 8601格式）、会议正文和所需与会者安排新的Microsoft Teams会议。

特性:

  • 使用唯一的加入URL创建团队会议。
  • 支持多个具有电子邮件地址和姓名的与会者。
  • 允许会议正文为HTML或纯文本。
  • 成功调度后返回事件ID和加入URL。 存储 event_id 重新安排或取消会议。

用法:

  • 方法: tools/call
  • 参数:
    • subject （string）：会议的标题。
    • body （string）：会议描述（HTML或纯文本）。
    • start_time （string）：ISO 8601 UTC格式的会议开始时间（例如。， 2025-09-10T18:00:00Z).
    • end_time （string）：ISO 8601 UTC格式的会议结束时间。
    • required_attendees （list）：与会者对象列表，每个对象都有 email （有效电子邮件）和 name （字符串）。

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "schedule_teams_meeting",
    "arguments": {
      "subject": "Technical Interview - Backend Engineer",
      "body": "Dear candidate,<br><br>Please join the Microsoft Teams meeting for your interview.<br><br>Regards,<br>Recruitment Team",
      "required_attendees": [
        {
          "email": "example@domain.com",
          "name": "Alice Applicant"
        }
      ],
      "start_time": "2025-09-10T18:00:00Z",
      "end_time": "2025-09-10T19:00:00Z"
    }
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "event_id": "AAMkADg0OWNmYTNjLTJlZmQtNDc2Ny1hNjAyLWNlZDE2MjEzNzAwMQBGAAAAAADbWWPmN-qjQqZ5uOjCatRNBwD4kwMhw138Q6oKJi3U2FGBAAAAAAENAAD4kwMhw138Q6oKJi3U2FGBAAFJIBYCAAA",
    "join_url": "https://teams.microsoft.com/l/meetup-join/..."
  }
}

2. reschedule_teams_meeting

描述：通过更新现有Microsoft Teams会议的开始和结束时间来重新安排会议。

特性:

  • 使用现有会议的事件ID更新其开始和结束时间。
  • 维护其他会议详细信息（例如，与会者、主题）。
  • 成功重新安排后返回事件ID。
  • 需要 event_id 来自之前安排的会议。

用法:

  • 方法: tools/call
  • 参数:
    • event_id （string）：要重新安排的会议的Microsoft Graph事件ID。
    • start_time （string）：ISO 8601 UTC格式的新开始时间。
    • end_time （string）：ISO 8601 UTC格式的新结束时间。

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reschedule_teams_meeting",
    "arguments": {
      "event_id": "AAMkADE1MzJlYTAwLWRkZTMtNDAyMy04ZTk2LTljOTI4OWRjYjg5MABGAAAAAABaL71tdJQET4NwOuYku0EHBwC7MkKjdoRHQ4cHEDY3mToXAAAAAAENAAC7MkKjdoRHQ4cHEDY3mToXAAFPchCuAAA=",
      "start_time": "2025-09-07T14:00:00Z",
      "end_time": "2025-09-07T16:00:00Z"
    }
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "event_id": "AAMkADE1MzJlYTAwLWRkZTMtNDAyMy04ZTk2LTljOTI4OWRjYjg5MABGAAAAAABaL71tdJQET4NwOuYku0EHBwC7MkKjdoRHQ4cHEDY3mToXAAAAAAENAAC7MkKjdoRHQ4cHEDY3mToXAAFPchCuAAA=",
    "join_url": ""
  }
}

3. cancel_teams_meeting

描述：使用事件ID取消现有的Microsoft Teams会议。

特性:

  • 从日历中删除会议。
  • 成功取消后返回确认消息。
  • 需要 event_id 来自之前安排的会议。

用法:

  • 方法: tools/call
  • 参数:
    • event_id （string）：要取消的会议的Microsoft Graph事件ID。

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "cancel_teams_meeting",
    "arguments": {
      "event_id": "AAMkADg0OWNmYTNjLTJlZmQtNDc2Ny1hNjAyLWNlZDE2MjEzNzAwMQBGAAAAAADbWWPmN-qjQqZ5uOjCatRNBwD4kwMhw138Q6oKJi3U2FGBAAAAAAENAAD4kwMhw138Q6oKJi3U2FGBAAFJIBYCAAA"
    }
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "message": "Interview 'AAMkADg0OWNmYTNjLTJlZmQtNDc2Ny1hNjAyLWNlZDE2MjEzNzAwMQBGAAAAAADbWWPmN-qjQqZ5uOjCatRNBwD4kwMhw138Q6oKJi3U2FGBAAAAAAENAAD4kwMhw138Q6oKJi3U2FGBAAFJIBYCAAA' canceled in Teams."
  }
}

4. list_team_calendar_events

描述：列出给定日期范围和时区内指定团队成员的日历事件。

特性:

  • 检索多个电子邮件地址的事件。
  • 支持自定义日期范围和时间与时区转换（IANA时区。， America/Los_Angeles).
  • 筛选事件，仅包括指定时间窗口内的事件。
  • 返回详细的活动信息（主题、开始/结束时间、地点、组织者、与会者、活动ID）。

用法:

  • 方法: tools/call
  • 参数:
    • emails （list）：用于获取事件的电子邮件地址列表。
    • start_date （string）：开始日期 YYYY-MM-DD 格式。
    • end_date （字符串，可选）：结束日期 YYYY-MM-DD 格式（默认为 start_date 如果没有提供）。
    • start_time （字符串，可选）：开始时间 HH:MM 格式（默认为 00:00).
    • end_time （字符串，可选）：结束时间 HH:MM 格式（默认为 23:59).
    • time_zone （字符串，可选）：IANA时区（默认为 UTC).

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_team_calendar_events",
    "arguments": {
      "emails": ["example@domain.com"],
      "start_date": "2025-09-07",
      "time_zone": "America/Los_Angeles"
    }
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "status": "success",
    "start_date": "2025-09-07",
    "end_date": "2025-09-07",
    "start_time": "00:00",
    "end_time": "23:59",
    "time_zone": "America/Los_Angeles",
    "events": {
      "example@domain.com": [
        {
          "subject": "Technical Interview - Backend Engineer",
          "start": "2025-09-07 11:00",
          "end": "2025-09-07 12:00",
          "location": "Microsoft Teams Meeting",
          "organizer": "Recruitment Team",
          "event_id": "AAMkADg0OWNmYTNjLTJlZmQtNDc2Ny1hNjAyLWNlZDE2MjEzNzAwMQBGAAAAAADbWWPmN-qjQqZ5uOjCatRNBwD4kwMhw138Q6oKJi3U2FGBAAAAAAENAAD4kwMhw138Q6oKJi3U2FGBAAFJIBYCAAA",
          "attendees": [
            {
              "emailAddress": {
                "address": "example@domain.com",
                "name": "Alice Applicant"
              },
              "type": "required"
            }
          ]
        }
      ]
    },
    "results": "[...]"
  }
}

5. get_teams_timezones

描述：检索所有IANA支持的时区列表，用于安排或筛选日历事件。

特性:

  • 返回由支持的IANA时区的完整列表 pytz 图书馆。
  • 有助于确保其他API调用的有效时区输入（例如。， list_team_calendar_events).

用法:

  • 方法: tools/call
  • 参数：没有。

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_teams_timezones",
    "arguments": {}
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "message": "List of IANA-supported time zones. You can also check at https://en.wikipedia.org/wiki/List_of_tz_database_time_zones",
    "timezones": [
      "Africa/Abidjan",
      "Africa/Accra",
      "America/Los_Angeles",
      ...
    ]
  }
}

列出可用工具

检索所有可用工具的列表（例如，发现 schedule_teams_meeting, reschedule_teams_meeting等），使用 tools/list 方法。

有效载荷示例:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {
    "cursor": "optional-cursor-value"
  }
}

示例响应:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "tools": [
      {
        "name": "schedule_teams_meeting",
        "description": "Schedule a Microsoft Teams meeting by specifying the subject, start/end times (ISO 8601 UTC), meeting body, and a list of required attendees..."
      },
      {
        "name": "reschedule_teams_meeting",
        "description": "Reschedule an existing interview in Microsoft Teams"
      },
      {
        "name": "cancel_teams_meeting",
        "description": "Cancel an interview in Microsoft Teams"
      },
      {
        "name": "list_team_calendar_events",
        "description": "List calendar events for team members between specified dates and times with timezone support"
      },
      {
        "name": "get_teams_timezones",
        "description": "List all IANA-supported time zones (used for scheduling and filtering calendar events)"
      }
    ],
    "next_cursor": null
  }
}

将LLM连接到MCP服务器

示例：OpenAI API

from openai import OpenAI

client = OpenAI(api_key="your_api_key_here")

resp = client.responses.create(
    model="gpt-4.1",
    tools=[
        {
            "type": "mcp",
            "server_label": "meetings_scheduler",
            "server_url": "https://yourdomain.com/mcp/",
            "require_approval": "never",
        },
    ],
    input="""
"Schedule a meeting titled 'Project Sync' starting at 2025-09-01T14:00:00Z ending at 2025-09-01T15:00:00Z. The body is 'Discuss project updates'. "
Please scheduel and let ,me know .
required Attendee name is Naveen and email is example@email.com

"""
)
print(resp)
print(resp.output_text)

# "Schedule a meeting titled 'Project Sync' starting at 2025-09-01T14:00:00Z ending at 2025-09-01T15:00:00Z. The body is 'Discuss project updates'. "
# Please scheduel and let ,me know .
# required Attendee name is Naveen and email is email@email.com

#could you please give me the event id of the meeting scheduled on August 9th, 2025 PST timezone with email@email.com """

#Can you please reschedule the meeting  event id 
# ET4NwOuYku0EHBwC7MkKjdoRHQ4cHEDY3mToXAAAAAAENAAC7MkKjdoRHQ4cHEDY3mToXAAFPchCwAAA=
#  to sept 20, 2025 same time.
# """
# Can you please cancel the interview  event id  is
# AAMAyMy04ZTk2LTljOTI4OWRjYjg5MABGAAAAAABaL71tdJQET4NwOuYku0EHBwC7MkKjdoRHQ4cHEDY3mToXAAAAAAENAAC7MkKjdoRHQ4cHEDY3mToXAAFPchCwAAA=

API 文档

有关端点和参数的更多详细信息，请参阅 Microsoft Graph API文档.

贡献

欢迎投稿！我们鼓励您通过添加新工具或增强现有工具来做出贡献，以进一步改进此MCP服务器的功能。请通过GitHub提交问题或拉取请求。看 贡献.md 作为指导方针。

许可证

该项目根据MIT许可证获得许可。看 许可证 了解详情。

相关 MCP