[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-MicrosoftDocs--mcp":3,"tool-MicrosoftDocs--mcp":62},[4,18,28,36,45,54],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":24,"last_commit_at":25,"category_tags":26,"status":17},9989,"n8n","n8n-io\u002Fn8n","n8n 是一款面向技术团队的公平代码（fair-code）工作流自动化平台，旨在让用户在享受低代码快速构建便利的同时，保留编写自定义代码的灵活性。它主要解决了传统自动化工具要么过于封闭难以扩展、要么完全依赖手写代码效率低下的痛点，帮助用户轻松连接 400 多种应用与服务，实现复杂业务流程的自动化。\n\nn8n 特别适合开发者、工程师以及具备一定技术背景的业务人员使用。其核心亮点在于“按需编码”：既可以通过直观的可视化界面拖拽节点搭建流程，也能随时插入 JavaScript 或 Python 代码、调用 npm 包来处理复杂逻辑。此外，n8n 原生集成了基于 LangChain 的 AI 能力，支持用户利用自有数据和模型构建智能体工作流。在部署方面，n8n 提供极高的自由度，支持完全自托管以保障数据隐私和控制权，也提供云端服务选项。凭借活跃的社区生态和数百个现成模板，n8n 让构建强大且可控的自动化系统变得简单高效。",184740,2,"2026-04-19T23:22:26",[16,14,13,15,27],"插件",{"id":29,"name":30,"github_repo":31,"description_zh":32,"stars":33,"difficulty_score":10,"last_commit_at":34,"category_tags":35,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":24,"last_commit_at":42,"category_tags":43,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",161147,"2026-04-19T23:31:47",[14,13,44],"语言模型",{"id":46,"name":47,"github_repo":48,"description_zh":49,"stars":50,"difficulty_score":51,"last_commit_at":52,"category_tags":53,"status":17},8272,"opencode","anomalyco\u002Fopencode","OpenCode 是一款开源的 AI 编程助手（Coding Agent），旨在像一位智能搭档一样融入您的开发流程。它不仅仅是一个代码补全插件，而是一个能够理解项目上下文、自主规划任务并执行复杂编码操作的智能体。无论是生成全新功能、重构现有代码，还是排查难以定位的 Bug，OpenCode 都能通过自然语言交互高效完成，显著减少开发者在重复性劳动和上下文切换上的时间消耗。\n\n这款工具专为软件开发者、工程师及技术研究人员设计，特别适合希望利用大模型能力来提升编码效率、加速原型开发或处理遗留代码维护的专业人群。其核心亮点在于完全开源的架构，这意味着用户可以审查代码逻辑、自定义行为策略，甚至私有化部署以保障数据安全，彻底打破了传统闭源 AI 助手的“黑盒”限制。\n\n在技术体验上，OpenCode 提供了灵活的终端界面（Terminal UI）和正在测试中的桌面应用程序，支持 macOS、Windows 及 Linux 全平台。它兼容多种包管理工具，安装便捷，并能无缝集成到现有的开发环境中。无论您是追求极致控制权的资深极客，还是渴望提升产出的独立开发者，OpenCode 都提供了一个透明、可信",144296,1,"2026-04-16T14:50:03",[13,27],{"id":55,"name":56,"github_repo":57,"description_zh":58,"stars":59,"difficulty_score":24,"last_commit_at":60,"category_tags":61,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",109154,"2026-04-18T11:18:24",[14,15,13],{"id":63,"github_repo":64,"name":65,"description_en":66,"description_zh":67,"ai_summary_zh":68,"readme_en":69,"readme_zh":70,"quickstart_zh":71,"use_case_zh":72,"hero_image_url":73,"owner_login":74,"owner_name":75,"owner_avatar_url":76,"owner_bio":77,"owner_company":78,"owner_location":78,"owner_email":79,"owner_twitter":80,"owner_website":81,"owner_url":82,"languages":83,"stars":96,"forks":97,"last_commit_at":98,"license":99,"difficulty_score":51,"env_os":100,"env_gpu":101,"env_ram":100,"env_deps":102,"category_tags":107,"github_topics":108,"view_count":24,"oss_zip_url":78,"oss_zip_packed_at":78,"status":17,"created_at":120,"updated_at":121,"faqs":122,"releases":152},9985,"MicrosoftDocs\u002Fmcp","mcp","Official Microsoft Learn MCP Server and CLI tool – powering LLMs and AI agents with real-time, trusted Microsoft docs & code samples.","mcp 是微软官方推出的 Model Context Protocol (MCP) 服务器与命令行工具，旨在为各类大语言模型（LLM）和 AI 智能体提供实时、可信的微软技术文档与代码示例接入能力。它核心解决了 AI 开发中常见的“幻觉”痛点：不再依赖过时的训练数据或不可靠的网络搜索，从而避免 AI 编造不存在的 Azure SDK 方法或错误的库包，确保生成的代码能够直接编译运行。\n\n这款工具特别适合广大开发者、架构师以及使用 Cursor、Copilot、Claude 等 AI 编程助手的技术人员。其独特亮点在于“即插即用”的便捷性与极高的安全性：无需注册账号、无需配置 API 密钥，一键安装即可在 VS Code 等环境中使用；且数据源严格限定为微软官方第一方文档，彻底规避了抓取恶意网站或过时博客的风险。此外，mcp 完全免费并提供高容量搜索支持，甚至兼容 OpenAI Deep Research 模型标准，允许用户通过参数灵活控制 Token 预算。无论是查询最新的 Azure CLI 命令，还是验证 .NET 8 的最佳实践，mcp 都能让 AI 助手基于权威信息给出精准回答","mcp 是微软官方推出的 Model Context Protocol (MCP) 服务器与命令行工具，旨在为各类大语言模型（LLM）和 AI 智能体提供实时、可信的微软技术文档与代码示例接入能力。它核心解决了 AI 开发中常见的“幻觉”痛点：不再依赖过时的训练数据或不可靠的网络搜索，从而避免 AI 编造不存在的 Azure SDK 方法或错误的库包，确保生成的代码能够直接编译运行。\n\n这款工具特别适合广大开发者、架构师以及使用 Cursor、Copilot、Claude 等 AI 编程助手的技术人员。其独特亮点在于“即插即用”的便捷性与极高的安全性：无需注册账号、无需配置 API 密钥，一键安装即可在 VS Code 等环境中使用；且数据源严格限定为微软官方第一方文档，彻底规避了抓取恶意网站或过时博客的风险。此外，mcp 完全免费并提供高容量搜索支持，甚至兼容 OpenAI Deep Research 模型标准，允许用户通过参数灵活控制 Token 预算。无论是查询最新的 Azure CLI 命令，还是验证 .NET 8 的最佳实践，mcp 都能让 AI 助手基于权威信息给出精准回答，显著提升开发效率与代码质量。","# 🌟 Microsoft Learn MCP Server\n[![Install in VS Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code-Install_Microsoft_Learn_MCP-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)\n[![Install in VS Code Insiders](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code_Insiders-Install_Microsoft_Learn_MCP-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Finsiders.vscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D&quality=insiders)\n\n> **Stop AI Hallucinations.** Give your AI assistant (Claude, Cursor, Copilot, Codex, ...) direct access to the latest official Microsoft documentation.\n>\n> **✨ Free. One-click install. No key needed.**\n\n## 🎯 Why install this?\n\nStop relying on outdated training data or risky web searches. Learn MCP server provides secure, direct access to Microsoft official docs.\n\n* 🧠 **Eliminate Hallucinations.**\n  Stop your AI from inventing non-existent Azure SDK methods or hallucinating library packages. Get code that actually compiles.\n\n* 🔌 **Plug & Play (No Auth).**\n  No API keys, no logins, no sign-ups required. Just one-click install and start coding immediately.\n\n* 🛡️ **100% Trusted & Safe.**\n  Protect your supply chain. Unlike generic web searches that may scrape insecure blogs or malicious sites, this tool **only** accesses official 1st-party Microsoft documentation.\n\n* 💸 **Completely Free.** High search capacity tailored for seamless, heavy coding sessions.\n\n### ✨ Example Prompts\n\n> \"Give me the Azure CLI commands to create an Azure Container App with a managed identity.\"\n\n> \"Is gpt-5.4 available in Azure EU regions?\"\n\n> \"Are you sure this is the right way to implement `IHttpClientFactory` in a .NET 8 minimal API?\"\n\n> \"Show me runnable Python code to do harms eval using the Azure AI Foundry evaluation SDK.\"\n\n## 🌐 The Microsoft Learn MCP Server Endpoint\n\nThe Microsoft Learn MCP Server is accessible to any IDE, agent, or tool that supports the Model Context Protocol (MCP). Any compatible client can connect to the following **remote MCP endpoint**:\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\n```\n> **Note:** This URL is intended for use **within a compliant MCP client** via Streamable HTTP, such as the recommended clients listed in our [Getting Started](#-installation--getting-started) section. It does not support direct access from a web browser and may return a `405 Method Not Allowed` error if accessed manually. For developers who need to build their own solution, please follow the mandatory guidelines in the [Building a Custom Client](#%EF%B8%8F-building-a-custom-client) section to ensure your implementation is resilient and supported.\n\n**Standard config** works in most clients:\n```json\n{\n  \"servers\": {\n    \"microsoft-learn\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\n    }\n  }\n}\n```\n\nFor experimental features, see the [Experimental Features](#-experimental-features) section below.\n\n## 🧪 Experimental Features\n\nThe Microsoft Learn MCP Server offers experimental features that are under active development. These features may change or be refined based on user feedback and usage patterns.\n\n### OpenAI-Compatible Endpoint\n\nFor applications that require OpenAI Deep Research model compatibility, you can use the OpenAI-compatible endpoint:\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\u002Fopenai-compatible\n```\n\nThis endpoint [supports OpenAI Deep Research models](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fmcp) and follows the OpenAI MCP specification.\n\n### Token Budget Control\n\nTo manage token usage and control costs, you can append the `maxTokenBudget` query parameter to the MCP endpoint URL. This parameter limits the token count in search tool responses by truncating the content to meet your specified budget.\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp?maxTokenBudget=2000\n```\n\n> **Note:** These experimental features are subject to change. We welcome feedback through our [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fdiscussions).\n\n## 🛠️ Currently Supported Tools\n\n| Tool Name | Description | Input Parameters |\n|-----------|-------------|------------------|\n| `microsoft_docs_search` | Performs semantic search against Microsoft official technical documentation | `query` (string): The search query for retrieval |\n| `microsoft_docs_fetch` | Fetch and convert a Microsoft documentation page into markdown format | `url` (string): URL of the documentation page to read |\n| `microsoft_code_sample_search` | Search for official Microsoft\u002FAzure code snippets and examples | `query` (string): Search query for Microsoft\u002FAzure code snippets\u003Cbr\u002F>`language` (string, optional): Programming language filter.|\n\n## 💻 Microsoft Learn CLI `preview`\n\n[![npm version](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@microsoft\u002Flearn-cli?style=flat-square&logo=npm&label=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@microsoft\u002Flearn-cli)\n\nThe [`@microsoft\u002Flearn-cli`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@microsoft\u002Flearn-cli) package gives you terminal access to the same tools — search docs, fetch pages, and find code samples — without an MCP client.\n\n```sh\n# Run instantly (no install)\nnpx @microsoft\u002Flearn-cli search \"azure functions timeout\"\n\n# Or install globally\nnpm install -g @microsoft\u002Flearn-cli\n# then use `mslearn`\nmslearn search \"azure functions timeout\"\n```\n\nPass `--json` to get structured JSON output, useful for programmatic processing:\n\n```sh\nmslearn search \"azure openai\" --json | jq '.results[].title'\n```\n\nSee [`cli\u002FREADME.md`](cli\u002FREADME.md) for the full command reference.\n\n## 🤖 Agent Skills\n\n[Agent Skills](https:\u002F\u002Fagentskills.io\u002F) are portable instruction packages that help AI agents use tools more effectively. We provide three skills that guide agents on when and how to use the Microsoft Learn MCP tools:\n\n| Skill | Purpose | Best For |\n|-------|---------|----------|\n| [`microsoft-docs`](skills\u002Fmicrosoft-docs\u002FSKILL.md) | Understanding concepts, tutorials, architecture, limits | \"How does X work?\", learning, configuration guides |\n| [`microsoft-code-reference`](skills\u002Fmicrosoft-code-reference\u002FSKILL.md) | API lookups, code samples, verification, error fixing | Implementing code, finding correct methods, troubleshooting |\n| [`microsoft-skill-creator`](skills\u002Fmicrosoft-skill-creator\u002FSKILL.md) | Meta-skill that generates custom agent skills for any Microsoft technology | Creating a skill to teach agents about a new Azure library, .NET feature, or other Microsoft tech |\n\n### Quick Setup\n\nThese agent skills are packed in a `microsoft-docs` plugin together with the Learn MCP server itself. If you use Claude Code, run the following command and restart Claude Code:\n```\n\u002Fplugin install microsoft-docs@claude-plugins-official\n```\n\nOr if you use GitHub Copilot CLI, run this command:\n```\n\u002Fplugin install microsoftdocs\u002Fmcp\n```\nOtherwise:\n1. **Install the MCP Server first** — See [Installation](#-installation--getting-started) below\n2. **Copy the skill folders** to your project's `.github\u002Fskills\u002F` or `.claude\u002Fskills\u002F` directory:\n   - [`microsoft-docs`](skills\u002Fmicrosoft-docs\u002F) — for concepts, tutorials, and factual lookups\n   - [`microsoft-code-reference`](skills\u002Fmicrosoft-code-reference\u002F) — for API lookups, code samples, and troubleshooting\n   - [`microsoft-skill-creator`](skills\u002Fmicrosoft-skill-creator\u002F) — meta-skill for generating custom skills about Microsoft technologies\n\n### Supported Agents\n\nAgent Skills work across multiple AI agents:\n- **VS Code** (Insiders) — enable `chat.useAgentSkills` setting\n- **GitHub Copilot CLI** & **Copilot coding agent**\n- **Claude Code**, **Cursor**, **OpenAI Codex**, and [more](https:\u002F\u002Fagentskills.io\u002F)\n\n### Which Skill Do I Need?\n\n| If you want to... | Install |\n|-------------------|---------|\n| Cover all Microsoft docs scenarios | All three skills |\n| Focus on coding (APIs, samples, errors) | `microsoft-code-reference` only |\n| Focus on facts & concepts (limits, config, tutorials) | `microsoft-docs` only |\n| Generate a custom skill for a specific Microsoft technology | `microsoft-skill-creator` only |\n\n\n## 🔌 Installation & Getting Started\n\nThe Microsoft Learn MCP Server supports quick installation across multiple development environments. Choose your preferred client below for streamlined setup:\n\n| Client | One-click Installation | MCP Guide |\n|--------|----------------------|-------------------|\n| **VS Code** | [![Install in VS Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D) \u003Cbr\u002F> or search \"@mcp learn\" in Extensions to show \"Microsoft Learn\" MCP | [VS Code MCP Official Guide](https:\u002F\u002Fcode.visualstudio.com\u002Fdocs\u002Fcopilot\u002Fchat\u002Fmcp-servers) |\n| **GitHub Copilot CLI** | `\u002Fplugin install microsoftdocs\u002Fmcp` | |\n| **Claude Desktop** | Follow \"Add custom connector\" instructions in official guide. | [Claude Desktop Remote MCP Guide](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fdevelop\u002Fconnect-remote-servers) |\n| **Claude Code** | `\u002Fplugin install microsoft-docs@claude-plugins-official` (includes MCP server + skills) | [Claude Code Remote MCP Guide](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmcp) |\n| **Visual Studio** | Upgrade to latest VS 2022 or 2026, \"Microsoft Learn\" MCP is already built-in | [Visual Studio MCP Official Guide](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fvisualstudio\u002Fide\u002Fmcp-servers?view=vs-2022) |\n| **Cursor IDE** | [![Install in Cursor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_in-Cursor-000000?style=flat-square&logoColor=white)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9) | [Cursor MCP Official Guide](https:\u002F\u002Fdocs.cursor.com\u002Fcontext\u002Fmodel-context-protocol) |\n| **Codex** | `codex mcp add \"microsoft-learn\" --url \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"`| [Codex MCP documentation](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Fblob\u002Fmain\u002Fcodex-rs\u002Fconfig.md#mcp_servers) |\n| **Roo Code** | Open [Roo Code Marketplace](https:\u002F\u002Fdocs.roocode.com\u002Ffeatures\u002Fmarketplace), search for `Microsoft Learn`, and click `Install` | [Roo Code MCP Official Guide](https:\u002F\u002Fdocs.roocode.com\u002Ffeatures\u002Fmcp\u002Fusing-mcp-in-roo) |\n| **Cline** | Manual configuration required\u003Cbr\u002F>Use `\"type\": \"streamableHttp\"` | [Cline MCP Official Guide](https:\u002F\u002Fdocs.cline.bot\u002Fmcp\u002Fconnecting-to-a-remote-server) |\n| **Gemini CLI** | Manual configuration required\u003Cbr\u002F> \u003Cdetails>\u003Csummary>View Config\u003C\u002Fsummary>**Note**: Add an `mcpServer` object to `.gemini\u002Fsettings.json` file\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"Microsoft Learn MCP Server\": {\u003Cbr\u002F>     \"httpUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\" \u003Cbr\u002F>   }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>  | [How to set up your MCP server](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli\u002Fblob\u002Fmain\u002Fdocs\u002Ftools\u002Fmcp-server.md#how-to-set-up-your-mcp-server)|\n| **Qwen Code** | Manual configuration required\u003Cbr\u002F> \u003Cdetails>\u003Csummary>View Config\u003C\u002Fsummary>**Note**: Add an `mcpServer` object to `.qwen\u002Fsettings.json` file\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"Microsoft Learn MCP Server\": {\u003Cbr\u002F>     \"httpUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\" \u003Cbr\u002F>   }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>  | [Configure the MCP server in settings.json](https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fen\u002Fcli\u002Ftutorials\u002F#configure-the-mcp-server-in-settingsjson)|\n| **GitHub** | Manual configuration required\u003Cbr\u002F> \u003Cdetails>\u003Csummary>View Config\u003C\u002Fsummary>**Note**: Navigate to Settings → Coding agent\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"mslearn\": {\u003Cbr\u002F>    \"type\": \"http\",\u003Cbr\u002F>    \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\",\u003Cbr\u002F>    \"tools\": [\u003Cbr\u002F>      \"*\"\u003Cbr\u002F>    ]\u003Cbr\u002F>  }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails> |\n| **ChatGPT** | Manual configuration required\u003Cbr\u002F> \u003Cdetails>\u003Csummary>View Instructions\u003C\u002Fsummary>1. Open ChatGPT in the browser\u003Cbr\u002F>2. Go to **Settings → Connectors → Advanced settings → Turn Developer mode on**\u003Cbr\u002F>3. Go back to connectors and click **create**\u003Cbr\u002F>4. Give the connector a **name**, enter **URL** `https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp`, set **authentication** to `No authentication` and **trust** the application\u003Cbr\u002F>5. Click **create**\u003Cbr\u002F> \u003C\u002Fdetails> | [ChatGPT Official Guide](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fguides\u002Fdeveloper-mode)|\n| **Windsurf** | Manual configuration required\u003Cbr\u002F> \u003Cdetails>\u003Csummary>View Config\u003C\u002Fsummary>\u003Cpre>{\u003Cbr\u002F>  \"mcpServers\": {\u003Cbr\u002F>    \"microsoft-learn\": {\u003Cbr\u002F>      \"serverUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\u003Cbr\u002F>    }\u003Cbr\u002F>  }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>| [Windsurf MCP Guide](https:\u002F\u002Fdocs.windsurf.com\u002Fwindsurf\u002Fcascade\u002Fmcp) |\n| **Kiro** | \u003Cdetails>\u003Csummary>View Config\u003C\u002Fsummary>\u003Cpre>{\u003Cbr\u002F>  \"microsoft-learn\": {\u003Cbr\u002F>    \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\u003Cbr\u002F>    }\u003Cbr\u002F>}\u003C\u002Fpre> \u003C\u002Fdetails>| [Kiro MCP Guide](https:\u002F\u002Fkiro.dev\u002Fdocs\u002Fmcp\u002Findex) |\n\n\n> ### ⚠️ Building a Custom Client\n>\n> If your use case requires a direct, programmatic integration, it is essential to understand that MCP is a **dynamic protocol, not a static API**. The available tools and their schemas will evolve.\n>\n> To build a resilient client that will not break as the service is updated, you should adhere to the following principles:\n>\n> 1.  **Discover Tools Dynamically:** Your client should fetch current tool definitions from the server at runtime (e.g., using `tools\u002Flist`). **Do not hard-code tool names or parameters.**\n> 2.  **Refresh on Failure:** Your client should handle errors during `tool\u002Finvoke` calls. If a tool call fails with an error indicating it is missing or its schema has changed (e.g., an HTTP 404 or 400 error), your client should assume its cache is stale and automatically trigger a refresh by calling `tools\u002Flist`.\n> 3.  **Handle Live Updates:** Your client should listen for server notifications (e.g., `listChanged`) and refresh its tool cache accordingly.\n\n## ❓ Troubleshooting\n\n### 💻 System Prompt\n\nEven tool-friendly models like Claude Sonnet 4 sometimes fail to call MCP tools by default; use system prompts to encourage usage.\n\nHere's an example of a Cursor rule (a system prompt) that will cause the LLM to utilize `microsoft-learn` more frequently:\n\n```md\n## Querying Microsoft Documentation\n\nYou have access to MCP tools called `microsoft_docs_search`, `microsoft_docs_fetch`, and `microsoft_code_sample_search` - these tools allow you to search through and fetch Microsoft's latest official documentation and code samples, and that information might be more detailed or newer than what's in your training data set.\n\nWhen handling questions around how to work with native Microsoft technologies, such as C#, F#, ASP.NET Core, Microsoft.Extensions, NuGet, Entity Framework, the `dotnet` runtime - please use these tools for research purposes when dealing with specific \u002F narrowly defined questions that may occur.\n```\n\n### ⚠️ Common Issues\n\n| Issue | Possible Solution |\n|-------|-------------------|\n| Connection errors | Verify your network connection and that the server URL is correctly entered |\n| No results returned | Try rephrasing your query with more specific technical terms |\n| Tool not appearing in VS Code | Restart VS Code or check that the MCP extension is properly installed |\n| HTTP status 405  | Method not allowed happens when a browser tries to connect to the endpoint. Try using the MCP Server through VS Code GitHub Copilot or [MCP Inspector](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Ftools\u002Finspector) instead. |\n\n### 🆘 Getting Support\n\n- [Ask questions, share ideas](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fdiscussions)\n- [Create an issue](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues)\n\n## 📚 Additional Resources\n\n- [Microsoft Learn MCP Server product documentation](https:\u002F\u002Flearn.microsoft.com\u002Ftraining\u002Fsupport\u002Fmcp)\n- [Microsoft MCP Servers](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmcp)\n- [Microsoft Learn](https:\u002F\u002Flearn.microsoft.com)\n- [Model Context Protocol Specification](https:\u002F\u002Fmodelcontextprotocol.io)\n","# 🌟 Microsoft Learn MCP 服务器\n[![在 VS Code 中安装](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code-Install_Microsoft_Learn_MCP-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)\n[![在 VS Code Insiders 中安装](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code_Insiders-Install_Microsoft_Learn_MCP-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Finsiders.vscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D&quality=insiders)\n\n> **阻止 AI 幻觉。** 让您的 AI 助手（Claude、Cursor、Copilot、Codex 等）直接访问最新的官方 Microsoft 文档。\n>\n> **✨ 免费。一键安装。无需密钥。**\n\n## 🎯 为什么要安装这个？\n\n不要再依赖过时的训练数据或有风险的网络搜索。Learn MCP 服务器提供安全、直接的 Microsoft 官方文档访问。\n\n* 🧠 **消除幻觉。**\n  阻止您的 AI 发明不存在的 Azure SDK 方法或编造库包。获取真正可以编译的代码。\n\n* 🔌 **即插即用（无需认证）。**\n  无需 API 密钥、登录或注册。只需一键安装，即可立即开始编码。\n\n* 🛡️ **100% 可信且安全。**\n  保护您的供应链。与可能抓取不安全博客或恶意网站的通用网络搜索不同，此工具**仅**访问官方的第一方 Microsoft 文档。\n\n* 💸 **完全免费。** 高搜索容量专为流畅、高强度的编码会话而设计。\n\n### ✨ 示例提示\n\n> “请给我创建具有托管标识的 Azure 容器应用的 Azure CLI 命令。”\n\n> “Azure 欧盟区域是否已推出 gpt-5.4？”\n\n> “您确定这是在 .NET 8 极简 API 中实现 `IHttpClientFactory` 的正确方式吗？”\n\n> “请展示使用 Azure AI Foundry 评估 SDK 运行 Python 代码以执行危害评估的示例。”\n\n## 🌐 Microsoft Learn MCP 服务器端点\n\nMicrosoft Learn MCP 服务器可被任何支持模型上下文协议 (MCP) 的 IDE、代理或工具访问。任何兼容客户端都可以连接到以下**远程 MCP 服务器端点**：\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\n```\n> **注意：** 此 URL 旨在通过流式 HTTP 在**合规的 MCP 客户端内**使用，例如我们在“入门”部分中推荐的客户端。它不支持从网页浏览器直接访问，如果手动访问可能会返回 `405 Method Not Allowed` 错误。对于需要构建自己解决方案的开发者，请遵循“构建自定义客户端”部分中的强制性指南，以确保您的实现具有弹性和得到支持。\n\n**标准配置**适用于大多数客户端：\n```json\n{\n  \"servers\": {\n    \"microsoft-learn\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\n    }\n  }\n}\n```\n\n有关实验性功能，请参阅下方的“实验性功能”部分。\n\n## 🧪 实验性功能\n\nMicrosoft Learn MCP 服务器提供正在积极开发的实验性功能。这些功能可能会根据用户反馈和使用模式进行更改或优化。\n\n### OpenAI 兼容端点\n\n对于需要 OpenAI Deep Research 模型兼容性的应用程序，您可以使用 OpenAI 兼容端点：\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\u002Fopenai-compatible\n```\n\n此端点[支持 OpenAI Deep Research 模型](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fmcp)，并遵循 OpenAI 的 MCP 规范。\n\n### 令牌预算控制\n\n为了管理令牌使用并控制成本，您可以将 `maxTokenBudget` 查询参数附加到 MCP 服务器端点 URL 上。此参数通过截断内容来限制搜索工具响应中的令牌数量，以满足您指定的预算。\n\n```\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp?maxTokenBudget=2000\n```\n\n> **注意：** 这些实验性功能可能会发生变化。我们欢迎通过我们的 [GitHub Discussions](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fdiscussions) 提供反馈。\n\n## 🛠️ 当前支持的工具\n\n| 工具名称 | 描述 | 输入参数 |\n|-----------|-------------|------------------|\n| `microsoft_docs_search` | 对 Microsoft 官方技术文档进行语义搜索 | `query`（字符串）：用于检索的搜索查询 |\n| `microsoft_docs_fetch` | 获取并把 Microsoft 文档页面转换成 Markdown 格式 | `url`（字符串）：要读取的文档页面的 URL |\n| `microsoft_code_sample_search` | 搜索 Microsoft\u002FAzure 官方代码片段和示例 | `query`（字符串）：Microsoft\u002FAzure 代码片段的搜索查询\u003Cbr\u002F>`language`（字符串，可选）：编程语言筛选器 |\n\n## 💻 Microsoft Learn CLI `预览版`\n\n[![npm 版本](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@microsoft\u002Flearn-cli?style=flat-square&logo=npm&label=npm)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@microsoft\u002Flearn-cli)\n\n[`@microsoft\u002Flearn-cli`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@microsoft\u002Flearn-cli) 包使您无需 MCP 客户端即可通过终端访问相同的功能——搜索文档、获取页面和查找代码示例。\n\n```sh\n# 即刻运行（无需安装）\nnpx @microsoft\u002Flearn-cli search \"azure functions timeout\"\n\n# 或者全局安装\nnpm install -g @microsoft\u002Flearn-cli\n# 然后使用 `mslearn`\nmslearn search \"azure functions timeout\"\n```\n\n传递 `--json` 可以获得结构化的 JSON 输出，便于程序化处理：\n\n```sh\nmslearn search \"azure openai\" --json | jq '.results[].title'\n```\n\n完整命令参考请参阅 [`cli\u002FREADME.md`](cli\u002FREADME.md)。\n\n## 🤖 代理技能\n\n[Agent Skills](https:\u002F\u002Fagentskills.io\u002F) 是便携式的指令包，可帮助 AI 代理更有效地使用工具。我们提供了三种技能，指导代理何时以及如何使用 Microsoft Learn MCP 工具：\n\n| 技能 | 目的 | 最适合 |\n|-------|---------|----------|\n| [`microsoft-docs`](skills\u002Fmicrosoft-docs\u002FSKILL.md) | 理解概念、教程、架构、限制 | “X 是如何工作的？”、“学习”、“配置指南” |\n| [`microsoft-code-reference`](skills\u002Fmicrosoft-code-reference\u002FSKILL.md) | API 查找、代码示例、验证、错误修复 | 实现代码、寻找正确方法、故障排除 |\n| [`microsoft-skill-creator`](skills\u002Fmicrosoft-skill-creator\u002FSKILL.md) | 一种元技能，可为任何 Microsoft 技术生成自定义代理技能 | 创建技能以教导代理关于新的 Azure 库、.NET 功能或其他 Microsoft 技术 |\n\n### 快速设置\n\n这些代理技能与 Learn MCP 服务器一同打包在 `microsoft-docs` 插件中。如果您使用 Claude Code，请运行以下命令并重启 Claude Code：\n```\n\u002Fplugin install microsoft-docs@claude-plugins-official\n```\n\n或者，如果您使用 GitHub Copilot CLI，请运行此命令：\n```\n\u002Fplugin install microsoftdocs\u002Fmcp\n```\n\n否则，请按照以下步骤操作：\n1. **先安装 MCP 服务器** — 请参阅下方的 [安装与入门](#-installation--getting-started) 部分。\n2. **将技能文件夹复制到您项目的 `.github\u002Fskills\u002F` 或 `.claude\u002Fskills\u002F` 目录中**：\n   - [`microsoft-docs`](skills\u002Fmicrosoft-docs\u002F) — 用于概念、教程和事实查询。\n   - [`microsoft-code-reference`](skills\u002Fmicrosoft-code-reference\u002F) — 用于 API 查询、代码示例和故障排除。\n   - [`microsoft-skill-creator`](skills\u002Fmicrosoft-skill-creator\u002F) — 用于生成关于 Microsoft 技术的自定义技能的元技能。\n\n### 支持的代理\n\nAgent Skills 可在多个 AI 代理中使用：\n- **VS Code**（Insiders 版）— 启用 `chat.useAgentSkills` 设置。\n- **GitHub Copilot CLI** 和 **Copilot 编程代理**。\n- **Claude Code**、**Cursor**、**OpenAI Codex** 等 [更多](https:\u002F\u002Fagentskills.io\u002F)。\n\n### 我需要哪种技能？\n\n| 如果您想… | 安装 |\n|-------------------|---------|\n| 涵盖所有 Microsoft 文档场景 | 三个技能全部安装 |\n| 专注于编码（API、示例、错误） | 仅安装 `microsoft-code-reference` |\n| 专注于事实与概念（限制、配置、教程） | 仅安装 `microsoft-docs` |\n| 为特定 Microsoft 技术生成自定义技能 | 仅安装 `microsoft-skill-creator` |\n\n## 🔌 安装与入门\n\nMicrosoft Learn MCP 服务器支持在多种开发环境中快速安装。请在下方选择您偏好的客户端，以进行简化的设置：\n\n| 客户端 | 一键安装 | MCP 指南 |\n|--------|----------------------|-------------------|\n| **VS Code** | [![在 VS Code 中安装](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_in-VS_Code-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D) \u003Cbr\u002F> 或在扩展中搜索 “@mcp learn” 以显示 “Microsoft Learn” MCP | [VS Code MCP 官方指南](https:\u002F\u002Fcode.visualstudio.com\u002Fdocs\u002Fcopilot\u002Fchat\u002Fmcp-servers) |\n| **GitHub Copilot CLI** | `\u002Fplugin install microsoftdocs\u002Fmcp` | |\n| **Claude Desktop** | 按照官方指南中的“添加自定义连接器”说明操作。 | [Claude Desktop 远程 MCP 指南](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Fdevelop\u002Fconnect-remote-servers) |\n| **Claude Code** | `\u002Fplugin install microsoft-docs@claude-plugins-official`（包含 MCP 服务器 + 技能） | [Claude Code 远程 MCP 指南](https:\u002F\u002Fcode.claude.com\u002Fdocs\u002Fen\u002Fmcp) |\n| **Visual Studio** | 升级到最新版 VS 2022 或 2026，“Microsoft Learn” MCP 已内置 | [Visual Studio MCP 官方指南](https:\u002F\u002Flearn.microsoft.com\u002Fen-us\u002Fvisualstudio\u002Fide\u002Fmcp-servers?view=vs-2022) |\n| **Cursor IDE** | [![在 Cursor 中安装](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_in-Cursor-000000?style=flat-square&logoColor=white)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9) | [Cursor MCP 官方指南](https:\u002F\u002Fdocs.cursor.com\u002Fcontext\u002Fmodel-context-protocol) |\n| **Codex** | `codex mcp add \"microsoft-learn\" --url \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"`| [Codex MCP 文档](https:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex\u002Fblob\u002Fmain\u002Fcodex-rs\u002Fconfig.md#mcp_servers) |\n| **Roo Code** | 打开 [Roo Code 市场](https:\u002F\u002Fdocs.roocode.com\u002Ffeatures\u002Fmarketplace)，搜索 “Microsoft Learn”，然后点击 “安装” | [Roo Code MCP 官方指南](https:\u002F\u002Fdocs.roocode.com\u002Ffeatures\u002Fmcp\u002Fusing-mcp-in-roo) |\n| **Cline** | 需要手动配置\u003Cbr\u002F>使用 `\"type\": \"streamableHttp\"` | [Cline MCP 官方指南](https:\u002F\u002Fdocs.cline.bot\u002Fmcp\u002Fconnecting-to-a-remote-server) |\n| **Gemini CLI** | 需要手动配置\u003Cbr\u002F> \u003Cdetails>\u003Csummary>查看配置\u003C\u002Fsummary>**注意**：将一个 `mcpServer` 对象添加到 `.gemini\u002Fsettings.json` 文件中\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"Microsoft Learn MCP Server\": {\u003Cbr\u002F>     \"httpUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\" \u003Cbr\u002F>   }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>  | [如何设置您的 MCP 服务器](https:\u002F\u002Fgithub.com\u002Fgoogle-gemini\u002Fgemini-cli\u002Fblob\u002Fmain\u002Fdocs\u002Ftools\u002Fmcp-server.md#how-to-set-up-your-mcp-server)|\n| **Qwen Code** | 需要手动配置\u003Cbr\u002F> \u003Cdetails>\u003Csummary>查看配置\u003C\u002Fsummary>**注意**：将一个 `mcpServer` 对象添加到 `.qwen\u002Fsettings.json` 文件中\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"Microsoft Learn MCP Server\": {\u003Cbr\u002F>     \"httpUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\" \u003Cbr\u002F>   }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>  | [在 settings.json 中配置 MCP 服务器](https:\u002F\u002Fqwenlm.github.io\u002Fqwen-code-docs\u002Fen\u002Fcli\u002Ftutorials\u002F#configure-the-mcp-server-in-settingsjson)|\n| **GitHub** | 需要手动配置\u003Cbr\u002F> \u003Cdetails>\u003Csummary>查看配置\u003C\u002Fsummary>**注意**：前往 设置 → 编码代理\u003Cbr\u002F>\u003Cpre>{\u003Cbr\u002F>  \"mslearn\": {\u003Cbr\u002F>    \"type\": \"http\",\u003Cbr\u002F>    \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\",\u003Cbr\u002F>    \"tools\": [\u003Cbr\u002F>      \"*\"\u003Cbr\u002F>    ]\u003Cbr\u002F>  }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails> |\n| **ChatGPT** | 需要手动配置\u003Cbr\u002F> \u003Cdetails>\u003Csummary>查看说明\u003C\u002Fsummary>1. 在浏览器中打开 ChatGPT\u003Cbr\u002F>2. 前往 **设置 → 连接器 → 高级设置 → 开启开发者模式**\u003Cbr\u002F>3. 返回连接器并点击 **创建**\u003Cbr\u002F>4. 为连接器命名，输入 **URL** `https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp`，将 **身份验证** 设置为 `无身份验证`，并信任该应用\u003Cbr\u002F>5. 点击 **创建**\u003Cbr\u002F> \u003C\u002Fdetails> | [ChatGPT 官方指南](https:\u002F\u002Fplatform.openai.com\u002Fdocs\u002Fguides\u002Fdeveloper-mode)|\n| **Windsurf** | 需要手动配置\u003Cbr\u002F> \u003Cdetails>\u003Csummary>查看配置\u003C\u002Fsummary>\u003Cpre>{\u003Cbr\u002F>  \"mcpServers\": {\u003Cbr\u002F>    \"microsoft-learn\": {\u003Cbr\u002F>      \"serverUrl\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\u003Cbr\u002F>    }\u003Cbr\u002F>  }\u003Cbr\u002F>}\u003C\u002Fpre>\u003C\u002Fdetails>| [Windsurf MCP 指南](https:\u002F\u002Fdocs.windsurf.com\u002Fwindsurf\u002Fcascade\u002Fmcp) |\n| **Kiro** | \u003Cdetails>\u003Csummary>查看配置\u003C\u002Fsummary>\u003Cpre>{\u003Cbr\u002F>  \"microsoft-learn\": {\u003Cbr\u002F>    \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\u003Cbr\u002F>    }\u003Cbr\u002F>}\u003C\u002Fpre> \u003C\u002Fdetails>| [Kiro MCP 指南](https:\u002F\u002Fkiro.dev\u002Fdocs\u002Fmcp\u002Findex) |\n\n\n> ### ⚠️ 构建自定义客户端\n>\n> 如果您的用例需要直接的程序化集成，务必了解 MCP 是一种 **动态协议，而非静态 API**。可用的工具及其架构会不断演进。\n>\n> 为了构建一个在服务更新时不会中断的稳健客户端，您应遵循以下原则：\n>\n> 1.  **动态发现工具：** 您的客户端应在运行时从服务器获取当前的工具定义（例如使用 `tools\u002Flist`）。**请勿硬编码工具名称或参数。**\n> 2.  **失败时刷新：** 您的客户端应处理 `tool\u002Finvoke` 调用中的错误。如果工具调用因缺少工具或其架构已更改而失败（例如 HTTP 404 或 400 错误），您的客户端应假定其缓存已过时，并自动通过调用 `tools\u002Flist` 触发刷新。\n> 3.  **处理实时更新：** 您的客户端应监听服务器通知（例如 `listChanged`），并相应地刷新其工具缓存。\n\n## ❓ 故障排除\n\n### 💻 系统提示\n\n即使是像 Claude Sonnet 4 这样擅长使用工具的模型，默认情况下有时也会无法调用 MCP 工具；请使用系统提示来鼓励其使用。\n\n以下是一个 Cursor 规则（系统提示）的示例，它会使 LLM 更频繁地使用 `microsoft-learn`：\n\n```md\n## 查询 Microsoft 文档\n\n您拥有名为 `microsoft_docs_search`、`microsoft_docs_fetch` 和 `microsoft_code_sample_search` 的 MCP 工具——这些工具允许您搜索和获取 Microsoft 最新的官方文档及代码示例，而这些信息可能比您训练数据集中的内容更加详细或更新。\n\n当处理有关如何使用原生 Microsoft 技术的问题时，例如 C#、F#、ASP.NET Core、Microsoft.Extensions、NuGet、Entity Framework 以及 `dotnet` 运行时，请在面对具体且范围狭窄的问题时，使用这些工具进行研究。\n```\n\n### ⚠️ 常见问题\n\n| 问题 | 可能的解决方案 |\n|-------|-------------------|\n| 连接错误 | 请检查您的网络连接，并确保服务器 URL 输入正确 |\n| 没有返回结果 | 尝试使用更具体的技术术语重新表述您的查询 |\n| 工具未在 VS Code 中显示 | 请重启 VS Code，或检查 MCP 扩展是否已正确安装 |\n| HTTP 状态 405 | “方法不允许”错误通常发生在浏览器尝试连接到端点时。建议改用 VS Code GitHub Copilot 或 [MCP Inspector](https:\u002F\u002Fmodelcontextprotocol.io\u002Fdocs\u002Ftools\u002Finspector) 来访问 MCP 服务器。 |\n\n### 🆘 获取支持\n\n- [提问、分享想法](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fdiscussions)\n- [创建问题](https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues)\n\n## 📚 其他资源\n\n- [Microsoft Learn MCP 服务器产品文档](https:\u002F\u002Flearn.microsoft.com\u002Ftraining\u002Fsupport\u002Fmcp)\n- [Microsoft MCP 服务器项目](https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fmcp)\n- [Microsoft Learn](https:\u002F\u002Flearn.microsoft.com)\n- [模型上下文协议规范](https:\u002F\u002Fmodelcontextprotocol.io)","# Microsoft Learn MCP Server 快速上手指南\n\nMicrosoft Learn MCP Server 是一个免费的官方工具，旨在让 AI 助手（如 Claude、Cursor、Copilot 等）直接访问最新的微软官方文档。它能有效消除 AI 幻觉，确保生成的代码基于真实存在的 API 和库，且无需任何 API 密钥或登录即可使用。\n\n## 环境准备\n\n*   **支持的客户端**：你需要一个支持 **Model Context Protocol (MCP)** 的 AI 开发工具。\n    *   推荐：**VS Code** (最新版或 Insiders 版), **Cursor**, **Claude Code**, **GitHub Copilot CLI**, **Visual Studio 2022\u002F2026**。\n    *   其他支持 MCP 的工具（如 Cline, Roo Code, Codex 等）也可通过手动配置使用。\n*   **网络连接**：需要能够访问 `https:\u002F\u002Flearn.microsoft.com`。\n*   **前置依赖**：\n    *   若使用 VS Code\u002FCursor 等图形界面工具，无需额外安装依赖。\n    *   若使用命令行工具，需安装 **Node.js** (用于运行 `npx` 或 `npm`)。\n\n> **注意**：目前该服务主要提供全球官方源，暂无专门的国内镜像加速方案。如遇网络延迟，请检查本地网络环境。\n\n## 安装步骤\n\n根据你的开发工具选择以下一种安装方式：\n\n### 方式一：VS Code \u002F Cursor (一键安装)\n\n这是最简便的方式，点击链接即可自动配置。\n\n*   **VS Code**:\n    [![Install in VS Code](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FVS_Code-Install_Microsoft_Learn_MCP-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https:\u002F\u002Fvscode.dev\u002Fredirect\u002Fmcp\u002Finstall?name=microsoft-learn&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Flearn.microsoft.com%2Fapi%2Fmcp%22%7D)\n    或者在扩展商店搜索 `@mcp learn` 找到 \"Microsoft Learn\" 并安装。\n\n*   **Cursor**:\n    [![Install in Cursor](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FInstall_in-Cursor-000000?style=flat-square&logoColor=white)](https:\u002F\u002Fcursor.com\u002Fen\u002Finstall-mcp?name=microsoft-learn&config=eyJuYW1lIjoibWljcm9zb2Z0LWxlYXJuIiwidHlwZSI6Imh0dHAiLCJ1cmwiOiJodHRwczovL2xlYXJuLm1pY3Jvc29mdC5jb20vYXBpL21jcCJ9)\n\n### 方式二：Claude Code \u002F GitHub Copilot CLI (插件命令)\n\n在终端中运行以下命令安装插件（包含 MCP 服务器及增强技能的 Agent Skills）：\n\n*   **Claude Code**:\n    ```bash\n    \u002Fplugin install microsoft-docs@claude-plugins-official\n    ```\n    *(安装后请重启 Claude Code)*\n\n*   **GitHub Copilot CLI**:\n    ```bash\n    \u002Fplugin install microsoftdocs\u002Fmcp\n    ```\n\n### 方式三：手动配置 (通用)\n\n如果你的工具不支持一键安装，请在 MCP 配置文件中添加以下服务器信息：\n\n```json\n{\n  \"servers\": {\n    \"microsoft-learn\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\"\n    }\n  }\n}\n```\n\n*   **Cline\u002FRoo Code\u002FQwen\u002FGemini 等**：通常在设置文件 (`settings.json` 或 MCP 配置页) 中添加上述 JSON 配置。注意部分工具可能需要将 `type` 设置为 `streamableHttp`。\n\n### 方式四：纯命令行使用 (无需 MCP 客户端)\n\n如果你只想在终端查询文档，可以使用官方 CLI 工具：\n\n```bash\n# 临时运行 (无需安装)\nnpx @microsoft\u002Flearn-cli search \"azure functions timeout\"\n\n# 或全局安装\nnpm install -g @microsoft\u002Flearn-cli\n# 安装后使用\nmslearn search \"azure functions timeout\"\n```\n\n## 基本使用\n\n安装完成后，直接在 AI 助手的对话框中提问即可。AI 会自动调用 Microsoft Learn 数据库获取最新信息。\n\n### 使用示例\n\n**场景 1：查询具体的 CLI 命令**\n> \"Give me the Azure CLI commands to create an Azure Container App with a managed identity.\"\n> (给我创建带有托管标识的 Azure Container App 的 Azure CLI 命令。)\n\n**场景 2：验证 API 可用性或版本信息**\n> \"Is gpt-5.4 available in Azure EU regions?\"\n> (gpt-5.4 在 Azure 欧盟区域可用吗？)\n\n**场景 3：确认代码实现是否正确**\n> \"Are you sure this is the right way to implement `IHttpClientFactory` in a .NET 8 minimal API?\"\n> (你确定这是在 .NET 8 Minimal API 中实现 `IHttpClientFactory` 的正确方法吗？)\n\n**场景 4：获取可运行的代码示例**\n> \"Show me runnable Python code to do harms eval using the Azure AI Foundry evaluation SDK.\"\n> (展示使用 Azure AI Foundry 评估 SDK 进行危害评估的可运行 Python 代码。)\n\n### 进阶技巧：控制 Token 用量\n\n如果你需要限制返回内容的长度以节省 Token，可以在配置 URL 时添加参数（仅适用于支持自定义 URL 参数的客户端）：\n\n```text\nhttps:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp?maxTokenBudget=2000\n```\n\n### 核心功能说明\n\n该工具主要提供以下三种能力供 AI 调用：\n1.  **语义搜索 (`microsoft_docs_search`)**：在微软官方技术文档中进行智能搜索。\n2.  **页面抓取 (`microsoft_docs_fetch`)**：将指定的微软文档页面转换为 Markdown 格式供 AI 阅读。\n3.  **代码示例搜索 (`microsoft_code_sample_search`)**：专门搜索官方的代码片段和示例（支持按编程语言过滤）。","一位后端开发者正在使用 AI 助手（如 Cursor 或 Copilot）为 .NET 8 项目集成 Azure Container Apps，并需要配置托管身份以访问密钥库。\n\n### 没有 mcp 时\n- **代码幻觉频发**：AI 基于过时的训练数据，编造了不存在的 Azure SDK 方法或错误的包名称，导致代码无法编译。\n- **文档验证耗时**：开发者必须手动离开 IDE，在浏览器中搜索并逐页核对 Microsoft 官方文档，确认 API 的最新用法。\n- **安全风险隐患**：AI 可能引用了非官方的技术博客或过时的社区教程，引入了潜在的安全漏洞或不推荐的实践方案。\n- **区域特性误判**：对于\"gpt-4 是否在 Azure 欧盟区域可用”等具体合规性问题，AI 往往给出模糊甚至错误的猜测。\n\n### 使用 mcp 后\n- **代码即插即用**：mcp 让 AI 直接读取最新的 Microsoft 官方文档，生成的 Azure CLI 命令和 C# 代码准确无误，首次运行即可通过。\n- **开发流零中断**：无需切换窗口查文档，所有关于 `IHttpClientFactory` 实现细节的疑问都在 IDE 内实时得到权威解答。\n- **来源绝对可信**：mcp 强制 AI 仅引用第一方微软文档，彻底杜绝了抓取恶意网站或非权威博客带来的供应链风险。\n- **精准回答细节**：面对复杂的区域可用性或服务配额问题，mcp 能提供基于实时文档的确切答案，消除不确定性。\n\nmcp 通过赋予 AI 实时访问权威微软文档的能力，将开发过程从“猜测与验证”转变为“确信与执行”，彻底终结了 AI 幻觉。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FMicrosoftDocs_mcp_f4c98da3.png","MicrosoftDocs","Microsoft Docs","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FMicrosoftDocs_db0b6823.png","The modern documentation service for Microsoft",null,"opensource@microsoft.com","docsmsft","https:\u002F\u002Flearn.microsoft.com","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs",[84,88,92],{"name":85,"color":86,"percentage":87},"TypeScript","#3178c6",76.2,{"name":89,"color":90,"percentage":91},"PowerShell","#012456",19.3,{"name":93,"color":94,"percentage":95},"JavaScript","#f1e05a",4.5,1565,184,"2026-04-19T23:17:13","CC-BY-4.0","未说明","无需求",{"notes":103,"python":100,"dependencies":104},"该工具主要作为远程 HTTP 服务运行，无需本地部署重型模型或特定硬件。用户只需在支持的 IDE 或代理工具中配置 endpoint (https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp) 即可使用。若使用命令行工具 (@microsoft\u002Flearn-cli)，则需要安装 Node.js 环境。",[105,106],"Node.js (用于 @microsoft\u002Flearn-cli)","支持 MCP 协议的客户端 (如 VS Code, Claude Desktop, Cursor 等)",[13,27,15,44,14],[109,110,111,65,112,113,114,115,116,117,118,119],"ai","ai-agents","documentation","microsoft","microsoft-learn","rag","copilot","llm","skills","cli","learn-cli","2026-03-27T02:49:30.150509","2026-04-20T12:53:01.213564",[123,128,133,138,143,148],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},44855,"如何配置 MCP 服务器以控制返回结果的数量并节省 Token 消耗？","MCP 端点现已支持实验性参数 `maxTokenBudget` 来控制 Token 预算和成本。您可以在 URL 中添加该参数，例如：`https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp?maxTokenBudget=2000`。\n\n行为说明：\n1. 服务器始终保持结果的排名顺序。\n2. 它会包含尽可能多的高排名结果的完整内容，直到达到 Token 预算上限。\n3. 排名较低的结果仍会返回，但仅包含 `title` 和 `contentUrl`，且标记为 `\"content_omitted\": true`。\n4. 对于代码示例搜索，保证不会出现片段截断：要么是完整内容，要么标记为省略。","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues\u002F82",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},44856,"调用 `microsoft_docs_search` 工具时，应该使用 `query` 还是 `question` 作为参数名？","根据官方维护和测试反馈，参数名应使用 `query`。如果您在使用 Python SDK 或严格模式（strict schema enforcement）时遇到错误，可能是因为 Schema 定义中未正确标记可选\u002F必填字段导致的兼容性问题，但在 .NET 和 Node.js SDK 中 `query` 是正常工作的。\n\n正确的调用示例（.NET）：\n```csharp\nvar response = await mcpClient.CallToolAsync(\"microsoft_docs_search\", new Dictionary\u003Cstring, object?>\n{\n    [\"query\"] = \"What is Microsoft Azure?\"\n});\n```\n如果某些 SDK 报错，请确保您的 MCP 客户端库已更新到最新版本以匹配服务端 Schema。","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues\u002F49",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},44857,"遇到 'Data Protection' 密钥错误或无法连接 MCP 服务器时如何解决？","如果直接使用 HTTP->stdio 适配器遇到数据保护密钥错误（如 'The key ... was not found in the key ring'），建议使用 `mcp-proxy` 作为中间层来转换传输协议。\n\n解决步骤：\n1. 安装 mcp-proxy：`uv tool install mcp-proxy`\n2. 在客户端配置中使用以下设置：\n```json\n{\n  \"mcpServers\": {\n    \"microsoft.docs.mcp\": {\n      \"command\": \"mcp-proxy\",\n      \"args\": [\n        \"--transport\",\n        \"streamablehttp\",\n        \"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\u002F\"\n      ]\n    }\n  }\n}\n```\n这通常能解决因客户端不支持 Streamable HTTP 或数据保护机制导致的连接问题。","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues\u002F40",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},44858,"VS Code 中连接 MCP 服务器出现 'TypeError: fetch failed' 或连接超时错误怎么办？","这通常是由于服务端之前的限流（throttling）策略或临时连接问题导致的。维护团队已经发布了修复补丁来解决部分用户遇到的限流问题。\n\n建议操作：\n1. 确认您的 VS Code 和 MCP 插件已更新至最新版本。\n2. 重试连接，大多数情况下服务端修复后问题会自动消失。\n3. 如果问题依旧，可以使用 MCP Inspector 工具检查本地与服务端的连通性，排除本地网络问题。","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues\u002F118",{"id":144,"question_zh":145,"answer_zh":146,"source_url":147},44859,"Claude (Desktop\u002FChat) 调用工具失败或受限，而 ChatGPT 正常，是什么原因？","此前部分用户从家庭 IP 使用 Claude 调用工具时遇到了限流或阻断问题，而其他应用（如 ChatGPT）正常。维护团队已针对此情况进行了缓解处理（mitigation）。\n\n如果您之前遇到此类问题，现在通常已经恢复正常。如果仍然失败，请检查是否触发了新的速率限制，或者尝试稍后重试。维护者确认该问题已通过后端调整得到改善。","https:\u002F\u002Fgithub.com\u002FMicrosoftDocs\u002Fmcp\u002Fissues\u002F135",{"id":149,"question_zh":150,"answer_zh":151,"source_url":132},44860,"如何在不同编程语言（Node.js, .NET, Python）中验证 MCP 工具调用是否正常？","您可以使用以下方法在不同环境中验证 `microsoft_docs_search` 工具：\n\n1. **Node.js**: 使用 inspector 工具\n   `npx @modelcontextprotocol\u002Finspector`\n\n2. **.NET**: \n   ```csharp\n   var response = await mcpClient.CallToolAsync(\"microsoft_docs_search\", new Dictionary\u003Cstring, object?>\n   {\n       [\"query\"] = \"What is Microsoft Azure?\"\n   });\n   ```\n\n3. **Python**: \n   使用 `streamablehttp_client` 连接：\n   ```python\n   async with streamablehttp_client(\"https:\u002F\u002Flearn.microsoft.com\u002Fapi\u002Fmcp\") as (read_stream, write_stream, _):\n       # 执行会话逻辑\n   ```\n如果在特定语言中失败，请提供代码片段以便调试，通常这与参数命名或 SDK 版本有关。",[]]