教程

如何在 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 服务器称为连接器。

要点

前提条件

要完成本教程,你需要:

第 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

Conduit 的详情与最新版本一致,可在文档和源代码中核对。 发现错误?告诉我们,我们会修正。

相关内容