Azure更新MCP服务器
MCP（模型上下文协议）服务器，为AI助手提供对Azure服务更新、退役和功能公告的无缝访问。
日文版本： Readme.ja.md
特性
- 🔍 更好的关键字匹配 -通过BM25相关性排名，在标题和描述之间进行全文搜索（FTS5），提供比原始API更好的查询搜索。
- 🎯 简化过滤 -按标签、类别、产品、日期和状态过滤——不需要OData知识。
- ⚡ 快速响应 -本地SQLite复制可确保\ ⚠️ 备注：在第一次运行时，将与本地缓存进行数据同步，这可能需要几分钟才能提供搜索查询。同步完成后，后续查询将快速响应。
选项2：使用npx
无需安装即可快速测试：
{
"servers": {
"azure-updates": {
"command": "npx",
"args": ["-y", "github:juyamagu/azure-updates-mcp-server"]
// Optional environment variables:
// "env": {
// "DATABASE_PATH": "${workspaceFolder}/.azure-updates/data.db",
// "SYNC_STALENESS_HOURS": "24",
// "LOG_LEVEL": "info"
// }
}
}
}备注：npx缓存的包可能会随着时间的推移消耗更多的磁盘空间。建议常规使用全局安装。
适用于Windows用户
如果 npm install ... 在Windows上失败（由于路径长度限制或 tsc 错误），请尝试从手动安装 .tgz 文件。
复制最新的URL .tgz 文件来自 发布页面 并直接安装。这消除了对本地构建的需求。
# Replace the URL with the actual latest release
npm install -g https://github.com/juyamagu/azure-updates-mcp-server/releases/download/v2.1.0/azure-updates-mcp-server-2.1.0.tgz用法
你只需要让你的人工智能助手使用 search_azure_updates 具有自然语言查询和可选过滤器的工具。
What are the latest security updates related to OAuth authentication in Azure since January 2025? Up to 10 results, please.您的助手会自动构造适当的参数并调用MCP服务器，如下所示：
{
"tool": "search_azure_updates",
"parameters": {
"query": "OAuth",
"filters": {
"tags": ["Security"],
"modifiedFrom": "2025-01-01"
},
"limit": 10
}
}GitHub Copilot的示例代理定义可以在以下位置找到：
配置
配置是通过环境变量完成的。创建 .env 文件或设置环境变量：
| 变量 | 默认值 | 描述 |
|---|---|---|
DATABASE_PATH | ~/.azure-updates-mcp/azure-updates.db | SQLite数据库的路径 |
SYNC_STALENESS_HOURS | 24 | 如果数据超过此小时数，则进行同步 |
SYNC_ON_STARTUP | true | 启用/禁用启动同步检查 |
DATA_RETENTION_START_DATE | 2022-01-01 | 自即日起保留更新（ISO 8601:YYYY-MM-DD） |
LOG_LEVEL | info | 日志级别：调试、信息、警告、错误 |
LOG_FORMAT | json | 日志格式：json或漂亮 |
看 .env.示例 对于所有配置选项。
可用工具
search_azure_updates
搜索和筛选Azure更新以查找相关项目。退货 仅元数据 （无描述）代币效率。
示例参数：
{
"query": "OAuth",
"filters": {
"tags": ["Security"],
"modifiedFrom": "2025-01-01"
},
"limit": 10
}get_azure_update
检索完整的更新详细信息，包括完整的Markdown描述和URL。
示例参数：
{
"id": "536699"
}推荐工作流程：
- 使用
search_azure_updates查找相关更新 - 使用
get_azure_update获取所选项目的完整详细信息
建筑
sequenceDiagram
participant LLM as AI Assistant
participant MCP as MCP Server
participant Search as Search Service
participant DB as SQLite DB
participant Sync as Sync Service
participant API as Azure API
Note over MCP,DB: Startup
MCP->>DB: Initialize database
MCP->>Sync: Check data staleness
alt Data is stale (>24h)
Sync->>API: Fetch updates (differential)
API-->>Sync: Return new/modified updates
Sync->>DB: Store updates
end
Note over LLM,DB: Query Execution
LLM->>MCP: search_azure_updates
(natural language query)
MCP->>Search: Execute search
Search->>DB: FTS5 query + filters
DB-->>Search: Matching results
Search-->>MCP: Ranked results
MCP-->>LLM: JSON response (>MCP: Get azure-updates://guide
MCP-->>LLM: Available filters & metadata使用FTS5全文搜索的本地SQLite复制提供了快速查询（\<500ms）。差异同步使Azure更新API中的数据保持新鲜。
技术栈：
- MCP-SDK:
@modelcontextprotocol/sdk - 数据库:
better-sqlite3使用FTS5 - 测试：Vitest与TypeScript严格模式
- 运行时：Node.js 18+
发展
看 开发指南 用于设置、测试和贡献说明。
故障排除
看 故障排除指南 常见问题和解决方案。
文档
- 从Tarball安装 -基于包的安装
- 故障排除 -常见问题
- 开发指南 -贡献和测试
- Azure更新API手册 -API参考
许可证
MIT许可证-请参阅 许可证 文件以获取详细信息。