microsoft-ai-roundup

Microsoft AI Roundup MCP 服务

一个用于搜索 Merill's Weekly Microsoft AI Roundup 存档的模型上下文协议（MCP）服务。这是由 Merill Fernando（与 Joanne Hayek 合作）精心整理的每周 Substack 通讯，内容涵盖 Microsoft AI：Copilot、GitHub、Azure AI、M365 AI 集成及相关生态系统。

你可以用自然语言提问，例如 “Copilot 是什么时候推出功能 X 的？”、“Roundup 对 Build 有什么说法？” 或 “它推荐过哪些 GitHub 项目？”，并获得附有期数、日期和链接的来源答案。

姊妹项目：entra-news-mcp。

快速开始

无需安装，无需 API 密钥，也无需配置：

npx microsoft-ai-roundup-mcp

首次运行时，服务会从此仓库的 GitHub Releases 下载预构建的搜索索引（SQLite 数据库），并在本地缓存。它最多每 7 天检查一次索引是否有更新。

需要 Node.js 22 或更高版本——服务使用 Node 内置的 node:sqlite 模块（无原生依赖项）。Node 20 无法运行。

客户端配置

Claude Desktop

将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "microsoft-ai-roundup": {
      "command": "npx",
      "args": ["microsoft-ai-roundup-mcp"]
    }
  }
}

Claude Code

claude mcp add microsoft-ai-roundup -- npx microsoft-ai-roundup-mcp

Cursor / VS Code / Copilot Studio

{
  "mcpServers": {
    "microsoft-ai-roundup": {
      "command": "npx",
      "args": ["-y", "microsoft-ai-roundup-mcp"]
    }
  }
}

可选：语义搜索

关键词搜索无需任何配置即可使用。如需语义（基于含义）搜索，请添加 OpenAI API 密钥：

{
  "mcpServers": {
    "microsoft-ai-roundup": {
      "command": "npx",
      "args": ["microsoft-ai-roundup-mcp"],
      "env": { "OPENAI_API_KEY": "sk-..." }
    }
  }
}

不提供密钥时，服务会平稳降级为仅使用关键词搜索。

工具

工具	描述
search_microsoft_ai_roundup	使用自然语言或关键词搜索完整存档。混合语义搜索与关键词搜索；返回附有期数、日期和 URL 的来源摘录。参数：query（必填）、limit（默认值为 10，最大值为 50）、mode（hybrid | semantic | keyword）。
get_issue	按 issue_number 或 date（YYYY-MM-DD 或 YYYY-MM）获取某期的完整内容，并保留章节标题。
list_issues	浏览存档，可选按 year/month 筛选并分页。
find_tool_mentions	查找各期提及的社区工具、GitHub 项目和 Microsoft AI 产品/功能，并显示相关上下文。可选使用 query 筛选。

示例查询

• “搜索 Microsoft AI roundup，查找 Copilot Studio Agent 公告”
• “获取 Microsoft AI roundup 第 4 期”
• “列出 2026 年 5 月发布的所有 roundup 期刊”
• “Microsoft AI roundup 提及过哪些 GitHub 项目？”

工作原理

Substack API (https://msai.ms/api/v1/posts)
     │
     ▼
TypeScript ingestion script (scripts/ingest.ts)
     │  weekly GitHub Action — Tuesdays 09:00 UTC
     ▼
OpenAI text-embedding-3-small embeddings (1536 dims)
     │
     ▼
SQLite via node:sqlite (Node 22 built-in — no native deps)
     │
     ▼
GitHub Release asset: microsoft-ai-roundup.db
     │
     ▼
NPX MCP Server (stdio)
  └─ Downloads DB on first run → caches in ~/.microsoft-ai-roundup-mcp/
  └─ Re-checks for updates weekly (7-day staleness + tag diff)
  └─ In-memory cosine similarity + SQL LIKE keyword search

**搜索实现（如实说明）：**语义搜索会在启动时将所有嵌入向量加载到内存，并在 JavaScript 中按余弦相似度排序；关键词搜索使用 SQL LIKE（先精确匹配短语，再逐词回退）。混合模式会合并并去重两组结果。不使用 sqlite-vec，也不使用 FTS5——实现刻意保持简单，对于此存档的规模而言已绰绰有余。

每周自动更新

GitHub Actions 工作流每周星期二 09:00 UTC运行（即通讯通常在星期一发布后的次日早晨）。它会增量导入新期刊、验证数据库，并将其作为新的 GitHub Release 发布，标签格式为 db-YYYY.MM.DD-NNNN。NPX 服务会在一周内自动获取新数据库（全新安装时则会立即获取）。workflow_dispatch 触发器可用于非计划发布或完整重建。

缓存位置

OS	路径
Windows	%USERPROFILE%\.microsoft-ai-roundup-mcp\
macOS / Linux	~/.microsoft-ai-roundup-mcp/

删除该文件夹即可强制重新下载最新数据库。

本地开发 / 摄取

git clone https://github.com/darrenjrobinson/microsoft-ai-roundup-mcp
cd microsoft-ai-roundup-mcp
npm install
npm run build

# Build the search index locally (requires an OpenAI API key for embeddings)
export OPENAI_API_KEY=sk-...
node dist/scripts/ingest.js               # full ingest
node dist/scripts/ingest.js --incremental # only new issues

# On Windows there's a PowerShell wrapper:
./scripts/ingest.ps1 -Incremental

# Run the server against your local database
MSAI_ROUNDUP_DB_PATH=./microsoft-ai-roundup.db npx microsoft-ai-roundup-mcp

环境变量	使用方	用途
OPENAI_API_KEY	摄取 + 服务	嵌入（摄取时必需；服务的语义搜索可选）
INGEST_DB_PATH	摄取	输出数据库路径（默认 ./microsoft-ai-roundup.db）
MSAI_ROUNDUP_DB_PATH	服务	使用本地数据库，而不是从 GitHub Releases 下载

权限与许可

Newsletter 内容版权归 Merill Fernando 和 Joanne Hayek 所有。本项目通过公开的 Substack API 为免费提供的公开档案建立索引（所有帖子均免费，audience: "everyone"），并始终链接回原始期刊。代码采用 MIT 许可证。

致谢

• Newsletter： Merill Fernando 和 Joanne Hayek — msai.ms
• MCP 服务： Darren Robinson
• 姊妹项目：entra-news-mcp，服务于 entra.news