教程
如何在 Windows 上设置 MCP 服务器
大多数 MCP 设置指南默认你用的是 Mac,并且要改 JSON 文件。这篇是为 Windows 写的,以 Conduit(一款免费、开源的桌面 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。可从发布页面下载最新版本。
- 在 Conduit 中设置好一个模型提供商。本教程通过 OpenRouter 使用 GLM 5.3 Flash;请参阅提供商指南(英文)。擅长调用工具的模型最适合配合连接器使用。
第 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)和本地命令。在本地命令下填写:
- 连接器名称:
Filesystem。 - 命令:
npx。 - 参数:
-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。
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 客户端,了解 Conduit 在 MCP 方面支持的一切。
- 最佳 MCP 客户端(英文),比较各款桌面 MCP 客户端。
- 如何在 Conduit 中让多个 AI 智能体并行工作,给智能体提供它能自行使用的连接器工具。
相关内容
- 如何用 AI 把 PDF 变成幻灯片 — 用 AI 把 PDF 报告变成可编辑的幻灯片:附上 PDF,确认故事线,生成幻灯片,修改文字,再导出为 HTML、PowerPoint 或 PDF。
- 如何与你的 PDF 对话并获得带引用的回答 — 同时在多份 PDF 中提问,并看到每个回答出自哪份文档的哪一段:建立集合,附到聊天中,核对来源。
- 如何在 Conduit 中让多个 AI 智能体并行工作 — 一次定义好 AI 智能体,各有自己的模型和工具;在聊天中把任务交给它们,看它们并行工作,请人审阅它们的成果,还能让它们按计划运行。
- 如何用 Conduit 工作流自动完成任务 — 分步教程:在 Conduit 中构建一个工作流,监视某个项目的发布动态,用低成本模型总结每个版本,保存总结,并且只在出现破坏性变更时通知你。
- 如何用 Conduit 和 Exa 做深度研究 — 分步教程:在 Conduit 中开启 Exa 搜索、写好研究简报,并阅读一份带引用的报告,以太阳能电池研究为例。无需 Exa 密钥。