项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1979
技术标签
使用教程
环境要求
- 已安装 Node.js,终端可用 npx / npm 命令
- 一个支持 MCP 的客户端(如 VS Code、Claude Code、Cursor、Codex 等)
- 可访问 https://learn.microsoft.com/api/mcp 的网络环境
安装与启动步骤
-
1免安装试用 CLI
不安装任何东西,直接用 npx 拉取并执行微软官方 learn-cli,验证能否查到文档。首次运行会下载包,稍等片刻。
npx @microsoft/learn-cli search "azure functions timeout" -
2全局安装 CLI
把 learn-cli 装到全局,后续可直接使用 mslearn 命令,无需每次走 npx。需要 npm 全局目录可写权限。
npm install -g @microsoft/learn-cli -
3为智能体配置 CLI
按 CLI-first 模式让检测到或选中的智能体通过 npx @microsoft/learn-cli@latest 检索文档,此模式不配置 MCP。可选指定 agent-target。
mslearn setup --cli -
4VS Code 一键安装
点击 README 中的 Install in VS Code 徽章,或在扩展面板搜索 "@mcp learn" 找到 Microsoft Learn MCP 安装。无需任何密钥。
-
5Codex 添加 MCP
用一条命令把微软 Learn 远程 MCP 端点注册到 Codex,之后 Codex 即可检索官方文档。
codex mcp add "microsoft-learn" --url "https://learn.microsoft.com/api/mcp" -
6Claude Code 装插件
在 Claude Code 中执行斜杠命令安装官方插件,插件自带 MCP 端点与 skills,安装后需重启 Claude Code。
/plugin install microsoft-docs@claude-plugins-official -
7其他客户端手动配置
Cline、Gemini CLI、Qwen Code、ChatGPT、Windsurf、Kiro 等需手动写入配置,统一指向 Learn MCP 端点地址。
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
url / httpUrl / serverUrl | 是 | 微软 Learn MCP 远程服务端点地址,所有客户端都填这个 | https://learn.microsoft.com/api/mcp |
type | 否 | Cline 需指定为流式 HTTP 类型 | streamableHttp |
tools | 否 | GitHub 编码智能体配置中开放的工具列表 | ["*"] |
如何确认成功
在已配置的 AI 助手里提问“Give me the Azure CLI commands to create an Azure Container App with a managed identity.”,若返回带官方文档依据的答案即成
常见问题
Q:需要 API Key 或注册登录吗?
A:不需要。README 明确说明 No Auth——无需 API key、无需登录、无需注册,免费一键安装即可使用。
Q:CLI 模式和 MCP 插件模式怎么选?
A:CLI-first 模式安装 @microsoft/learn-cli 后运行 mslearn setup --cli,智能体走 npx 调用、不配置 MCP;仓库插件模式(Copilot、Claude Code、Codex)则直接提供 Learn MCP 端点与 MCP 技能。
Q:为什么配置里没有本地端口和 Docker 命令?
A:微软 Learn MCP Server 是托管在 learn.microsoft.com 上的远程 HTTP 服务,不需要本地部署或 Docker,客户端只需填写远端 URL。
Q:自定义客户端要注意什么?
A:MCP 是动态协议而不是静态 API,可用工具及其 schema 会变化,客户端应动态拉取当前工具定义,避免服务更新后失效。
Q:Visual Studio 用户要额外装吗?
A:升级到最新 VS 2022 或 2026 后,Microsoft Learn MCP 已内置,无需单独安装。
注意事项
- 服务完全免费、无需密钥,但只检索微软一方官方文档,不覆盖第三方博客内容
- 部分客户端(Cline、Gemini CLI、Qwen Code、ChatGPT、Windsurf、Kiro)必须手动写配置文件,不能一键安装
- Claude Code 插件除 MCP 外还包含 skills,可把 microsoft-docs、microsoft-code-reference 等技能目录复制到项目的 .github/skills/ 或 .claude/skills/
- 安装插件或修改配置后通常需要重启客户端才能生效
核心亮点
- 官方出品,文档和代码示例来源权威可信,数据实时更新
- 基于 MCP 标准协议,可无缝接入主流 AI 智能体框架
- 提供 CLI 工具,开发者可快速在终端中检索和集成
不足之处
- 仅覆盖微软生态,对非微软技术栈支持有限
- 文档/社区待观察
适用场景
- 开发 AI 编程助手,需要准确回答微软技术栈问题
- 构建企业知识库智能体,整合微软官方文档
- 在 CI/CD 中自动检索最新 API 变更并更新代码
替代项目
MCP Servers (modelcontextprotocol/servers)、LangChain Document Loaders、GitHub Copilot Chat
同类项目推荐
照着文档一步步来,AI 代理几分钟就能接好
PixelDesk — public docs & agent-connection guide. Site: pixeldesk.ai
pokechamp
开源
让语言模型在宝可梦对战中达到专家级水平
Official repository of the spotlight ICML 2025 paper, PokeChamp: an Expert-level Min···
juno-code
开源
设定任务清单,AI 自动逐个执行并提交代码
YYLO (why-lo): AI coding-agent orchestration CLI with equivalent yylo and yy launche···
concord-mcp
开源
给AI编码代理装上统一协作中枢,告别工具碎片化
Live messaging for coding agents
omnigent
开源
一套框架统一指挥所有AI编码助手,免重写、强管控。
Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude C···
data-to-paper
开源
让AI帮你从数据一键生成可追溯的科研论文
data-to-paper: Backward-traceable AI-driven scientific research
odoo-mcp-pro
开源
把 Odoo 变成 AI 助手的数据源,用自然语言查 ERP 数据
AI connector for Odoo ERP | Connect Claude, ChatGPT, Cursor and other AI tools to Od···
LISA
开源
让 AI 拥有灵魂和欲望,自主行动而非被动响应
Open-source AI Personal Assistant for planning, writing and personal knowledge. Use ···
aspire-skills
开源
让AI代理直接上手.NET分布式应用开发,从初始化到部署一条龙。
Official Aspire skills and plugins for AI coding agents to initialize, wire, orchest···
