Microsoft 365 路线图 MCP 服务器
一个模型上下文协议（MCP）服务器，它从微软官方发布通讯API中获取Microsoft 365路线图项目，并为Copilot Studio提供这些项目。
🚀 功能特点
- 8个MCP工具 用于检索和浏览 Microsoft 365 路线图项目
- OData v2 API 带灵活过滤器的支持（或：配备灵活过滤器的支撑）
- REST API（Representational State Transfer Application Programming Interface，表述性状态传递应用程序编程接口） 通过 HTTP/JSON
- 已准备好部署 用于Azure和GitHub
- 与Copilot Studio兼容
- MCP最佳实践 “konform”在中文中可以翻译为“符合”或“一致”。这个词汇通常用于描述某物或某人与某种标准、要求或期望相契合或相一致的状态。例如：“他的行为与公司的规定相符合（konform）。”
📋 可用工具
1. get_roadmap_items
检索所有Microsoft 365路线图项目，并可选择应用OData过滤器。
参数：
limit（可选）：项目最大数量（默认：100）offset（可选）：要跳过的项目数量（默认：0）filter（可选）：OData 过滤字符串（例如：“products/any(p:p eq 'Microsoft Teams')”）
示例：
{
"limit": 50,
"filter": "status eq 'Launched'"
}2. search_roadmap
在路线图项目中按关键词搜索（客户端）。
参数：
keyword标题和描述中的搜索词limit（可选）：最大结果数量（默认：20）
示例：
{
"keyword": "Copilot",
"limit": 10
}3. get_roadmap_item
根据ID检索特定的路线图项目。
参数：
id路线图项目的ID
示例：
{
"id": "497417"
}4. filter_by_product
按微软产品筛选项目（使用OData数组过滤器）。
参数：
product产品名称（例如“Microsoft Copilot（Microsoft 365）”，“Microsoft Teams”，“SharePoint”）limit（可选）：项目最大数量（默认：100）
示例：
{
"product": "Microsoft Copilot (Microsoft 365)",
"limit": 50
}5. filter_by_release_phase
按发布周期/阶段筛选项目。
参数：
phase发布阶段（“正式发布”、“公开预览”、“开发中”、“逐步推出”）limit（可选）：项目最大数量（默认：100）
示例：
{
"phase": "General Availability",
"limit": 20
}6. filter_by_status
根据当前状态筛选项目。
参数：
status状态（“开发中”，“推出中”，“已发布”）limit（可选）：最大项目数（默认：100）
示例：
{
"status": "Rolling out"
}7. filter_by_date
根据GA或预览日期过滤项目。
参数：
date日期格式为YYYY-MM（例如“2025-10”表示2025年10月）dateType（可选）：“generalAvailability” 或 “preview”（默认：“generalAvailability”）limit（可选）：项目最大数量（默认：100）
示例：
{
"date": "2025-10",
"dateType": "generalAvailability"
}8. filter_roadmap (高级)
支持复杂的OData过滤查询。
参数：
filterOData 过滤表达式limit（可选）：项目最大数量（默认：100）
示例：
{
"filter": "products/any(p:p eq 'Microsoft Copilot (Microsoft 365)') and generalAvailabilityDate eq '2025-10'"
}{
"filter": "status eq 'Launched' and releaseRings/any(r:r eq 'General Availability')"
}🔍 OData 过滤器语法
该API支持OData v2过滤器：
数组过滤器（用于产品、平台、发布环）
products/any(p:p eq 'Microsoft Teams')
platforms/any(p:p eq 'Web')
releaseRings/any(r:r eq 'General Availability')比较运算符
status eq 'Launched'
generalAvailabilityDate eq '2025-10'
generalAvailabilityDate ge '2025-10' (greater or equal)
generalAvailabilityDate le '2025-12' (less or equal)逻辑运算符
status eq 'Launched' and generalAvailabilityDate eq '2025-10'
status eq 'Rolling out' or status eq 'Launched'示例查询
2025年10月的Copilot项目：
products/any(p:p eq 'Microsoft Copilot (Microsoft 365)') and generalAvailabilityDate eq '2025-10'公共预览版中的 Teams 项目：
products/any(p:p eq 'Microsoft Teams') and releaseRings/any(r:r eq 'Public Preview')所有项目自2025年10月起：
generalAvailabilityDate ge '2025-10'🛠️ 安装与本地开发
前提条件
- Node.js 18.x 或更高版本
- npm 或 yarn
设置
# Repository klonen
git clone
cd "Roadmap MCP"
# Dependencies installieren
npm install
# Projekt bauen
npm run build
# Server starten
npm start然后服务器就会运行起来 http://localhost:3000/mcp
开发模式
npm run dev🌐 部署
Azure Web 应用
- 创建Azure Web App：
az webapp create \
--name m365-roadmap-mcp \
--resource-group \
--plan \
--runtime "NODE|20-lts"- 设置GitHub机密（Secrets）：
- 转到存储库设置 > 密钥 - 添加 AZURE_WEBAPP_PUBLISH_PROFILE 加上；增加 - 从Azure门户导出发布配置文件
- 自动部署：
- 推动（或催促）至 main 分支触发通过GitHub Actions进行自动部署
Docker（注：Docker是一个用于开发、打包和运行应用程序的开源平台，它允许开发者将应用程序及其依赖项打包到一个可移植的容器中，从而确保应用程序在任何环境中都能一致地运行。）
# Build Docker Image
docker build -t m365-roadmap-mcp .
# Run Container
docker run -p 3000:3000 m365-roadmap-mcpAzure 容器实例
# Build und Push zu Container Registry
docker build -t .azurecr.io/m365-roadmap-mcp:latest .
docker push .azurecr.io/m365-roadmap-mcp:latest
# Deploy zu Azure Container Instances
az container create \
--resource-group \
--name m365-roadmap-mcp \
--image .azurecr.io/m365-roadmap-mcp:latest \
--dns-name-label m365-roadmap-mcp \
--ports 3000🔌 Copilot Studio 集成
1. MCP 服务器 URL
部署后，请记录下URL：
- Azure Web App（Azure 网页应用）：
https://m365-roadmap-mcp.azurewebsites.net/mcp - Azure 容器：
https://.region.azurecontainer.io:3000/mcp
2. 在Copilot Studio中进行配置
- 打开Copilot Studio
- 去 设置 > MCP 服务器
- 点击 添加服务器
- 配置：
- 名字Microsoft 365 发展路线图 - 类型HTTP - URL（统一资源定位符）： /mcp
- 保存
3. 使用工具
这8个工具现已在Copilot Studio中可用：
get_roadmap_items- 所有项目均配有可选过滤器search_roadmap- 关键词搜索get_roadmap_item- 根据ID查询单个项目filter_by_product- 按产品筛选（例如：Copilot、Teams、SharePoint）filter_by_release_phase- 过滤掉已发布的戒指filter_by_status- 按状态筛选filter_by_date- 按日期筛选filter_roadmap- 扩展的OData查询
4. 示例请求
2025年10月的所有Copilot项目：
Tool: filter_roadmap
Filter: products/any(p:p eq 'Microsoft Copilot (Microsoft 365)') and generalAvailabilityDate eq '2025-10'团队项目在部署中：
Tool: filter_by_product
Product: Microsoft Teams
+ filter_by_status
Status: Rolling out🧪 测试
使用MCP Inspector进行本地测试
npx @modelcontextprotocol/inspector node build/index.js健康检查
curl http://localhost:3000/health工具调用示例
获取所有路线图项目：
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_roadmap_items",
"arguments": {
"limit": 10
}
},
"id": 1
}'搜索路线图：
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "search_roadmap",
"arguments": {
"keyword": "Teams",
"limit": 5
}
},
"id": 1
}'筛选2025年10月的Copilot项目
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "filter_roadmap",
"arguments": {
"filter": "products/any(p:p eq '\''Microsoft Copilot (Microsoft 365)'\'') and generalAvailabilityDate eq '\''2025-10'\''",
"limit": 50
}
},
"id": 1
}'获取特定路线图项目：
curl -X POST http://localhost:3000/mcp \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "get_roadmap_item",
"arguments": {
"id": "497417"
}
},
"id": 1
}'📚 API 参考文档
Microsoft 365路线图API
- 终端点 v2：
https://www.microsoft.com/releasecommunications/api/v2/m365 - 协议带数组过滤器的OData v2
- 文档记录： Microsoft 365 发展路线图
可用的过滤字段：
id(数字)：路线图项目IDtitle(字符串)：项目标题description(字符串)：描述status(字符串): "开发中", "逐步推出", "已发布"products(array): 受影响产品的列表platforms(array): 平台列表（Web、桌面、移动等）releaseRings(数组): "正式发布", "公开预览", 等。cloudInstances(array): 云实例generalAvailabilityDate(字符串)：GA日期，格式为YYYY-MMpreviewAvailabilityDate(字符串): 预览日期，格式为YYYY-MMcreated(datetime): 创建日期modified(datetime): 修改日期
MCP协议
- 规格/说明: 模型上下文协议
- 版本2025年6月18日
🔧 配置
环境变量
PORT=3000 # Server Port (Standard: 3000)
NODE_ENV=production # Node Umgebung📁 项目结构
.
├── src/
│ └── index.ts # MCP Server Implementation
├── build/ # Kompilierte TypeScript Dateien
├── .github/
│ └── workflows/
│ ├── azure-deploy.yml # Azure Deployment
│ └── build.yml # Build & Test
├── .azure/
│ └── config.yml # Azure Konfiguration
├── Dockerfile # Docker Container Setup
├── package.json # Node.js Dependencies
├── tsconfig.json # TypeScript Konfiguration
└── README.md # Diese Datei🤝 贡献
欢迎投稿！请：
- 为该仓库创建分支
- 创建一个特性分支
- 提交你的更改
- 推送到分支
- 创建一个拉取请求
📝 许可证
MIT 许可证 - 详情请参阅 LICENSE 文件
🆘 支持
如有疑问或问题：
- 创建一个
- 请咨询 MCP 文档
- 访问 Microsoft 365 路线图
🔗 链接
- 模型上下文协议
- Microsoft 365 发展路线图
- Copilot Studio（可译为“协作者工作室”或根据具体语境译为更贴切的名称，但直接保留原名在技术或产品语境中也常见）
- Azure Web Apps（Azure 网页应用）