<!-- Generated from zh-CN/mcp-servers-windows.md. Do not edit by hand. -->

> Markdown twin of https://conduitllm.com/zh-CN/mcp-servers-windows.html
> 在 Windows 上设置 MCP 服务器：安装 Node.js 和 uv，用 npx 或 uvx 添加本地服务器，通过 URL 或注册表添加远程服务器，排查常见错误。

---
教程

# 如何在 Windows 上设置 MCP 服务器

更新于 2026年10月31日

大多数 MCP 设置指南默认你用的是 Mac，并且要改 JSON 文件。这篇是为 Windows 写的，以 [Conduit](https://conduitllm.com/zh-CN/)（一款免费、开源的桌面 AI 应用）作为客户端：要安装什么， 每个字段里填什么，以及服务器无法启动时错误是什么意思。

## 简介

模型上下文协议（MCP）让 AI 应用可以使用其他程序提供的工具：读写文件、搜索文档、查询数据库、创建 issue。每一组工具都来自一个 **MCP 服务器**。**本地**服务器是应用在你电脑上启动的程序，通常用 `npx`（Node.js）或 `uvx`（Python）运行。**远程**服务器运行在别处，通过 URL 访问。

在 Windows 上，本地服务器失败往往有几个可以预见的原因：运行环境没有安装，或者不在 `PATH` 中；应用试图把 shell 脚本当作程序来运行；或者文件夹路径里有空格。本教程会避开这些问题。

你将安装 Node.js 和 uv，用 `npx` 添加官方的 **Filesystem** 服务器，用 `uvx` 添加 **Fetch** 服务器，再添加 **Microsoft Learn**，这是一个提供 Microsoft 文档的远程服务器。然后你会在聊天中使用它们，批准一个会修改文件的工具，并看看无法启动的服务器是什么样子、该怎么修复。在 Conduit 中，MCP 服务器称为**连接器**。

## 要点

- 为 `npx` 服务器安装 Node.js，为 `uvx` 服务器安装 uv，然后重启 Conduit，让它在 `PATH` 中看到它们。
- 命令直接填 `npx` 或 `uvx`。Conduit 会自己找到 `npx.cmd` 和其他 Windows 启动器；不要用 `cmd /c` 包装它们。
- 参数按空格拆分，所以文件夹路径中不能有空格。
- 远程服务器不需要安装任何东西：通过 URL 添加，或在官方注册表中查找。
- 只读取内容的工具会直接运行。会更改内容的工具会先询问，并显示它们将发送的确切内容。

## 前提条件

要完成本教程，你需要：

- **Windows 10 或 11**，并带有 **winget**；当前版本的 Windows 自带它。
- **已安装 Conduit**。可从[发布页面](https://github.com/runningpixels/conduit/releases)下载最新版本。
- **在 Conduit 中设置好一个模型提供商**。本教程通过 OpenRouter 使用 GLM 5.3 Flash；请参阅[提供商指南](https://conduitllm.com/providers.html)（英文）。擅长调用工具的模型最适合配合连接器使用。

## 第 1 步 — 安装 Node.js 和 uv

大多数本地 MCP 服务器是 Node.js 包（用 `npx` 启动）或 Python 包（用 `uvx` 启动）。在这一步，你要安装这两个运行环境。

打开 PowerShell 并运行：

```
winget install OpenJS.NodeJS.LTS
winget install astral-sh.uv
```

uv 会下载每个服务器所需的 Python 版本，所以你不用单独安装 Python。关闭 PowerShell，打开一个新窗口，检查两者都能找到：

```
npx --version
uvx --version
```

两者都会输出一个版本号。如果 PowerShell 说无法识别该命令，请先注销 Windows 再重新登录，让新的 `PATH` 生效，然后重试。

最后，**退出 Conduit 并重新打开**，如果它还在通知区域中运行，也要从那里退出。程序看到的是它启动时的 `PATH`，所以在安装期间一直开着的 Conduit 还找不到 `npx` 或 `uvx`。

接下来，你要添加第一个服务器。

## 第 2 步 — 用 npx 添加本地服务器

Filesystem 服务器为助手提供列出、读取、搜索和写入文件的工具，但只能在你指定的文件夹内使用。在这一步，你要为一个文件夹添加它。

在侧边栏中选择**上下文**，再选择顶部的**连接器**，然后选择**添加连接器**。面板提供三种添加服务器的方式：**官方 MCP 注册表**、**远程服务器（URL）**和**本地命令**。在**本地命令**下填写：

1. **连接器名称**：`Filesystem`。
2. **命令**：`npx`。
3. **参数**：`-y @modelcontextprotocol/server-filesystem C:\Users\Public\Documents\Northwind`，末尾换成你自己的文件夹。`-y` 让 `npx` 不经询问就下载这个包。

**环境变量**留空；这个服务器不需要密钥。选择**添加本地连接器**。连接器会列为**已停止**。选择**启动**。

第一次启动要稍微久一点，因为 `npx` 要下载这个包。之后状态会变为**运行中**，并列出该服务器的工具，每个都标明了它的作用：

标为**只读**的工具无需询问就会运行。标为**会做更改，先询问**的工具每次都会请求你的批准，除非你让 Conduit 记住。Conduit 根据服务器对每个工具的声明来给出这些标签。

Conduit 启动服务器时不会打开控制台窗口。命令是直接运行的，从不经过 shell，所以这里的 `npx` 不需要 `cmd /c`：Conduit 会自己在 `PATH` 中查找这个名称，并找到 `npx.cmd`。

接下来，你要添加一个 Python 服务器。

## 第 3 步 — 用 uvx 添加本地服务器

Python 服务器的做法相同，命令用 `uvx`。在这一步，你要添加 Fetch 服务器，它会下载网页并转换成 Markdown。

再次选择**添加连接器**。在**本地命令**下，名称输入 `Fetch`，命令输入 `uvx`，参数输入 `mcp-server-fetch`：

选择**添加本地连接器**，再选择**启动**。第一次启动会下载服务器及其 Python 包，需要几秒钟，之后连接器进入**运行中**状态，带有一个工具 `fetch`。

**注意：** Conduit 自己已经有网页搜索和页面读取功能。Fetch 在这里只是作为 Python 服务器的示例；任何发布为 `uvx` 的服务器，添加方式都一样。

接下来，你要添加一个远程运行的服务器。

## 第 4 步 — 添加远程服务器

远程服务器不需要安装任何东西。在这一步，你要添加 Microsoft Learn，这是 Microsoft 官方提供的文档搜索服务器，不需要账户。

你可以在官方 MCP 注册表中找到远程服务器。在**添加连接器**中，在**官方 MCP 注册表**下输入一个词，然后选择**搜索**：

**安装**会从列表中添加一个服务器。注册表对所有人开放，所以安装之前请先确认服务器是谁发布的。如果你知道服务器的地址，也可以直接添加。在**远程服务器（URL）**下，名称输入 `Microsoft Learn`，URL 输入 `https://learn.microsoft.com/api/mcp`：

选择**添加远程连接器**，再选择**启动**。连接器进入**运行中**状态，带有三个工具，分别用于搜索文档、查找代码示例和读取页面，全部标为**只读**。

需要账户的远程服务器会显示**需登录**，而不是直接启动。在连接器上选择**登录**，在浏览器中完成登录，Conduit 就会保存它获得的访问权限。

接下来，你要在聊天中使用这些服务器。

## 第 5 步 — 在聊天中使用服务器

在这一步，你要先问一个由连接器回答的问题，再要求做一个需要你批准的更改。

选择**聊天**和**新建聊天**。Conduit 会让模型在需要时自行查找连接器的工具，所以你不用打开任何东西。想让某个服务器被用到，最可靠的办法是点名它。发送：

```
使用 Microsoft Learn 连接器：我怎么查看自己运行的是哪个版本的 PowerShell，
又怎么在 Windows 11 上更新它？请附上你参考的页面链接。
```

每次工具调用在回复中占一行，显示连接器和工具名称、询问的内容以及用时。点击其中一行，可以看到发送出去的确切内容和返回的结果。这些搜索只是读取，所以不经询问就运行了。

现在要求做一个会修改文件的操作。在新聊天中发送：

```
使用 Filesystem 连接器：列出 C:\Users\Public\Documents\Northwind 中的文件，
然后在那里创建一个名为 reading-list.md 的文件，根据文件名，为每份 PDF 写一句话，
说明它大概讲什么。
```

列出文件夹只是读取，所以会直接运行。写入文件则会停下来等你：

提示会显示工具、服务器对它的说明，以及将要发送的数据，包括路径和要写入的内容。**拒绝**会中止操作。勾选**在本次聊天中记住**，可让这个工具在本次聊天中再次运行时不再询问；勾选**始终允许这个工具**则对所有聊天生效；然后选择**批准并运行**。

文件现在就在文件夹里了。以后想查看或撤回已记住的批准，请在连接器页面打开该连接器，在**已记住的工具批准**下使用**忘记**。

## 第 6 步 — 修复无法启动的服务器

在这一步，你要看看失败的服务器是什么样子，以及如何找出原因。

一启动就退出的服务器会显示为**已下线**，并附上 Conduit 看到的原因：

**connector stdout closed (child exited)** 的意思是服务器启动后又退出了，通常是因为它打印了一条错误。要看到这条错误，请在 PowerShell 中运行相同的命令和参数。对上面的连接器来说：

```
npx -y @modelcontextprotocol/server-filesystem C:\Users\Public\Shared Files
```

```
Warning: Cannot access directory C:\Users\Public\Shared, skipping
Error: None of the specified directories are accessible
```

路径中有空格，所以它被拆成了两个参数，`C:\Users\Public\Shared` 和 `Files`，而两者都不是文件夹。Windows 用户最常遇到的原因：

| 你看到的现象 | 原因 | 解决办法 |
| --- | --- | --- |
| `spawn 'npx' failed` | 没有安装 Node.js，或者 Conduit 是在安装之前启动的。 | 安装它（第 1 步），然后完全退出 Conduit 并重新打开。 |
| 命令被拒绝 | 命令是一个 shell，例如 `cmd`、`powershell` 或 `wsl`。Conduit 不会通过 shell 运行命令。 | 在**命令**中填程序本身：`npx`、`uvx`、`node`、`python`，或者 `.exe` 的完整路径。 |
| 带文件夹参数的服务器**已下线** | 路径中有空格。**参数**会在每个空格处拆分。 | 使用路径中没有空格的文件夹，例如 `C:\Users\Public\Documents\Projects`。 |
| 需要密钥的服务器**已下线** | 缺少密钥。 | 以 `KEY=VALUE` 的形式添加到**环境变量**中，变量名使用服务器文档里给出的名称。 |

要更改连接器的命令或参数，请用新的值重新添加一个，然后打开旧的那个并选择**撤销**，这会停止它并关闭它的工具。

## 常见问题

**使用 MCP 服务器需要安装 Node.js 和 Python 吗？**

只有用它们编写的本地服务器才需要。用 `npx` 启动的服务器需要 Node.js，用 `uvx` 启动的服务器需要 uv，而 uv 会自己获取 Python。通过 URL 或注册表添加的远程服务器运行在别处，不需要安装任何东西。Conduit 本身两者都不需要。

**可以沿用我的 Claude Desktop MCP 配置吗？**

不能直接导入那个文件，但可以使用相同的值。对 `claude_desktop_config.json` 中的每个服务器，把 `command` 填入**命令**，把 `args` 的各项用空格分隔后填入**参数**，把 `env` 的每一项作为一行 `KEY=VALUE` 填入**环境变量**。

**可以添加需要 API 密钥的远程服务器吗？**

只有它使用 OAuth 登录时才可以。Conduit 通过浏览器用 OAuth 登录远程服务器，使用连接器上的**登录**按钮，目前没有用于填写 API 密钥请求头的字段。同时也能在本地运行的服务器，通常以环境变量的方式接收密钥，你可以在**环境变量**中设置。

**MCP 服务器会以我的权限运行吗？**

会。本地服务器是你电脑上的一个程序，你的 Windows 账户能做的它都能做，所以只添加你信任的、来源可靠的服务器。Conduit 会在运行任何会更改内容的工具之前询问，但每个工具具体做什么，由服务器自己决定。

**这在 macOS 和 Linux 上也适用吗？**

适用。连接器页面在所有平台上都一样。请用你的包管理器代替 winget 安装 Node.js 和 uv，并使用 `/Users/you/Documents` 这样的路径；教程的其余部分照常适用。

## 结语

在本教程中，你安装了 Node.js 和 uv，用 `npx` 添加了一个本地 MCP 服务器，用 `uvx` 添加了另一个，通过 URL 添加了一个远程服务器并从注册表中查找了服务器，在聊天中使用了它们，批准了一个会写入文件的工具，并诊断了一个无法启动的服务器。

任何本地服务器需要的都是同样三个字段：命令、参数和环境变量，所以 MCP 注册表和项目 README 中的服务器，都可以用同样的方式设置。想继续深入，可以看看这些指南：

- [Conduit 作为你的 MCP 客户端](https://conduitllm.com/zh-CN/use-cases/mcp-client.html)，了解 Conduit 在 MCP 方面支持的一切。
- [最佳 MCP 客户端](https://conduitllm.com/best-mcp-clients.html)（英文），比较各款桌面 MCP 客户端。
- [如何在 Conduit 中让多个 AI 智能体并行工作](https://conduitllm.com/zh-CN/run-ai-agents.html)，给智能体提供它能自行使用的连接器工具。

[下载 Conduit](https://conduitllm.com/zh-CN/#get)

Conduit 的详情与最新版本一致，可在[文档](https://conduitllm.com/zh-CN/docs.html)和[源代码](https://github.com/runningpixels/conduit)中核对。 发现错误？[告诉我们](https://github.com/runningpixels/conduit/discussions)，我们会修正。

## 相关内容

- [如何用 AI 把 PDF 变成幻灯片](https://conduitllm.com/zh-CN/pdf-to-slides.html) — 用 AI 把 PDF 报告变成可编辑的幻灯片：附上 PDF，确认故事线，生成幻灯片，修改文字，再导出为 HTML、PowerPoint 或 PDF。
- [如何与你的 PDF 对话并获得带引用的回答](https://conduitllm.com/zh-CN/chat-with-pdfs.html) — 同时在多份 PDF 中提问，并看到每个回答出自哪份文档的哪一段：建立集合，附到聊天中，核对来源。
- [如何在 Conduit 中让多个 AI 智能体并行工作](https://conduitllm.com/zh-CN/run-ai-agents.html) — 一次定义好 AI 智能体，各有自己的模型和工具；在聊天中把任务交给它们，看它们并行工作，请人审阅它们的成果，还能让它们按计划运行。
- [如何用 Conduit 工作流自动完成任务](https://conduitllm.com/zh-CN/automate-with-workflows.html) — 分步教程：在 Conduit 中构建一个工作流，监视某个项目的发布动态，用低成本模型总结每个版本，保存总结，并且只在出现破坏性变更时通知你。
- [如何用 Conduit 和 Exa 做深度研究](https://conduitllm.com/zh-CN/research-with-exa.html) — 分步教程：在 Conduit 中开启 Exa 搜索、写好研究简报，并阅读一份带引用的报告，以太阳能电池研究为例。无需 Exa 密钥。
