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 网页应用)
