目录什么是Cursor MCP服务器在 Cursor 中设置 MCP 服务器逐步设置方法一手动配置方法二命令面板配置格式Cursor MCP 服务器使用与 Claude Desktop 相同的 JSON 格式对于基于 Python 的 MCP 服务器远程服务器配置最佳 MCP 光标服务器网络搜索与研究GitHub 集成数据库访问浏览器自动化文件操作记忆与知识Cursor 与 Claude Code MCP何时使用Cursor MCP 与 Claude 代码 MCP光标 MCP 在以下情况下会发光Claude Code MCP 在以下情况下表现出色排查 Cursor MCP 服务器故障MCP 工具未在设置中启用服务器未加载无错误身份验证失败未找到 npx 命令Windows路径引用问题远程服务器连接问题工具显示但无法运行服务器在会话中途悄无声息地崩溃后续步骤资料来源如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。在 Cursor IDE 中设置 MCP 服务器。提供分步指南包括故障排除、可用配置以及 Cursor 与 Claude Code 的比较。问题您想使用外部工具和数据源扩展 Cursor但 MCP 配置过程不太清楚。文件应该放在哪里它们使用什么格式它与 Claude Code 相比如何快速入门.cursor/mcp.json在项目根目录下创建一个文件并添加你的第一个 MCP 服务器{mcpServers: {brave-search: {command: npx,args: [-y, modelcontextprotocol/server-brave-search],env: { BRAVE_API_KEY: your-api-key }}}}重启 Cursor 后您现在可以在 IDE 内部使用网络搜索功能。截至 2026 年 5 月经测试本指南中的 Cursor 配置可在 macOS 14、Windows 11 和 Ubuntu 22.04 上使用 0.45 及更高版本。本指南中的所有配置均已在当前 Cursor 稳定版上测试通过。0.45 之前的 Cursor 版本使用不同的设置界面如果您使用的是旧版本请先更新至最新版本再继续操作。什么是Cursor MCP服务器Cursor MCP 服务器通过模型上下文协议将 Cursor 的 AI 与外部工具、数据库和 API 连接起来。由于它们都使用相同的底层协议因此它们与 Claude Code 和 Claude Desktop 中的 MCP 服务器的工作方式完全相同。配置好 MCP 服务器后Cursor 可以搜索网络并获取文档使用自然语言查询数据库与 GitHub、Slack 和其他服务进行交互自动化浏览器测试任务通过 MCP 服务器实现访问任何服务MCP 生态系统在所有兼容工具之间共享。任何与 Claude Desktop 兼容的 MCP 服务器也与 Cursor 兼容。在 Cursor 中设置 MCP 服务器配置文件位置光标支持两个配置位置LocationPathScopeProject-level.cursor/mcp.jsonOnly this projectGlobal~/.cursor/mcp.jsonAll Cursor workspaces对于项目特定的工具例如应用程序的数据库服务器请使用项目级配置。对于需要在所有地方使用的工具例如网络搜索或 GitHub请使用全局配置。逐步设置方法一手动配置.cursor/mcp.json在项目或~/.cursor/mcp.json全局位置创建配置文件。添加您的 MCP 服务器配置重启 Cursor 以加载新服务器测试方法是让 AI 使用你服务器上的工具。方法二命令面板打开命令面板Mac 系统CmdShiftPWindows 系统CtrlShiftP搜索“MCP”然后选择“查看打开MCP设置”。在 MCP 工具下点击“新建 MCP 服务器”。光标创建并打开 mcp.json 文件进行编辑配置格式Cursor MCP 服务器使用与 Claude Desktop 相同的 JSON 格式{mcpServers: {server-name: {command: npx,args: [-y, modelcontextprotocol/server-name],env: {API_KEY: your-key-here}}}}对于基于 Python 的 MCP 服务器{mcpServers: {python-server: {command: python,args: [path/to/server.py],env: {DATABASE_URL: postgresql://localhost/mydb}}}}远程服务器配置Cursor 还支持通过 HTTP 连接远程 MCP 服务器{mcpServers: {remote-server: {url: http://localhost:3000/mcp,headers: {Authorization: Bearer your-token}}}}这使得可以连接到运行在远程计算机上或作为共享服务运行的 MCP 服务器。Cursor 的 HTTP 和 SSE 传输协议会自动处理重新连接如果远程服务器重启Cursor 会在下次调用该工具时重新连接。最佳 MCP 光标服务器这些 Cursor MCP 服务器提供最强大的功能。所有配置均可直接在您的系统中运行.cursor/mcp.json。以下每个条目都显示了配置及其在您的日常工作流程中实际解锁的功能。网络搜索与研究{mcpServers: {brave-search: {command: npx,args: [-y, modelcontextprotocol/server-brave-search],env: { BRAVE_API_KEY: your-key }}}}您可以这样做在对话过程中让 Cursor 查找当前的 API 文档查找 Stack Overflow 上关于晦涩错误的讨论帖或者在不离开编辑器的情况下获取依赖项的最新变更日志。GitHub 集成{mcpServers: {github: {command: npx,args: [-y, modelcontextprotocol/server-github],env: { GITHUB_TOKEN: your-token }}}}您可以执行以下操作打开和分类问题、评论拉取请求、从另一个分支获取差异以供审查或者从最近 20 个合并的 PR 生成发行说明而无需切换到 GitHub UI。数据库访问{mcpServers: {postgres: {command: npx,args: [-y, modelcontextprotocol/server-postgres],env: { DATABASE_URL: postgresql://user:passlocalhost/db }}}}您可以执行以下操作让 Cursor 检查您的模式针对真实表编写查询运行 EXPLAIN ANALYZE并针对您的开发数据库副本调试失败的迁移。浏览器自动化{mcpServers: {playwright: {command: npx,args: [-y, executeautomation/playwright-mcp-server]}}}您可以这样做让 Cursor 打开一个页面点击完成一个流程截取结果屏幕截图然后编写一个 Playwright 测试来重现这些步骤。有关高级模式请参阅浏览器自动化指南。文件操作{mcpServers: {filesystem: {command: npx,args: [-y,modelcontextprotocol/server-filesystem,/path/to/allowed/directory]}}}您可以执行以下操作赋予 Cursor 对打开的工作区之外的目录的读/写权限——这对于跨仓库重构或在不打开同级项目的情况下从同级项目拉取资源非常有用。记忆与知识{mcpServers: {memory: {command: npx,args: [-y, modelcontextprotocol/server-memory]}}}您可以执行以下操作将项目决策、术语表术语或架构注释在 Cursor 会话中保存到知识图谱中以便 AI 稍后可以查询。浏览我们的完整 MCP 服务器列表了解 50 多个其他选项。Cursor 用户需要注意两款值得关注的供应商 MCPShopify AI Toolkit和Higgsfield MCP都支持 Cursor 的.cursor/mcp.json配置格式无需修改即可使用。如果您已经在使用 Claude Code 运行这些 MCP则可以直接复制相同的配置块。Cursor 与 Claude Code MCPCursor 和 Claude Code 都使用相同的模型上下文协议因此服务器包可以互换。区别在于传输方式、配置的易用性和上下文处理。FeatureCursorClaude CodeConfig location.cursor/mcp.json~/.claude.jsonor.mcp.jsonTransport typesstdio, SSE, HTTPstdio (HTTP/SSE in some preview builds)OAuth supportBuilt-in OAuth flow with browser-handled authManual token paste inenvblockTool searchNot available — all tools loaded at session startTool Search — lazy loading on demandResourcesNot yet supportedSupportedHot reloadRestart Cursor required for config changesReloads on.mcp.jsonedit in some buildsPer-project scope.cursor/mcp.jsonper projectProject-level.mcp.jsonworks the same way何时使用Cursor MCP 与 Claude 代码 MCP这两个工具针对不同的工作流程进行了优化。光标 MCP 在以下情况下会发光您需要完整的 IDE 功能多光标编辑、内联建议、重构菜单以及 MCP 驱动的 AI。您的团队已经统一使用 Cursor现在您想在不更换 IDE 的情况下集成 MCP。您需要使用支持 OAuth 认证的服务例如 GitHub、Notion、Linear并且不想手动管理 API 令牌。您的 MCP 服务器数量很少启动时全部负载的开销无关紧要。Claude Code MCP 在以下情况下表现出色你正在终端中工作想要一个更精简、更快速的上下文循环您有很多 MCP 服务器需要工具搜索延迟加载以保持上下文精简Cursor 在启动时全部加载的成本在超过约 10 台服务器后会迅速增加。您正在协调多代理或多会话工作流程在这种情况下终端比集成开发环境 (IDE) 更合适。您需要资源支持对模型提供只读文件/数据访问权限以便在不调用工具的情况下进行接地。一个实用的模式是许多开发者同时运行这两个工具。Cursor 处理那些与 IDE 紧密相关的工作例如需要内联建议和重构的操作。Claude Code 则处理长时间运行的编排、批量重构以及任何涉及多个 MCP 服务器的会话。两者都支持相同的服务器软件包。为 Claude Desktop 配置的服务器可以在 Cursor 中运行反之亦然。这种可移植性值得注意如果您使用像ClaudeFast 的 Code Kit这样的入门套件搭配 Claude Code那么它提供的 MCP 配置只需进行少量调整即可应用到 Cursor 项目中。排查 Cursor MCP 服务器故障以下是出现频率最高的故障模式、它们产生的实际错误消息以及有效的修复方法。MCP 工具未在设置中启用症状您已向 添加了服务器.cursor/mcp.json并重新启动了 Cursor但 AI 显示没有可用工具。可能原因光标的 MCP 功能被限制在一个设置开关后面该开关在某些安装中默认处于关闭状态。解决方法打开 Cursor 设置Cmd/Ctrl ,搜索“MCP”并确认“启用 MCP 服务器”已勾选。然后重启 Cursor。在命令面板中运行命令MCP: View Server Status以确认服务器已加载。服务器未加载无错误症状MCP 服务器未出现在可用工具中没有明显的错误。使固定请验证 JSON 语法是否有效不能有尾随逗号也不能有注释——JSON 不支持这两种格式。彻底重启 Cursor 程序退出并重新启动而不仅仅是重新加载窗口检查“输出”面板查看 输出 从下拉菜单中选择“MCP”以查看加载错误在 macOS 上检查~/Library/Logs/Cursor/文件mcp-*.log在 Windows 上%APPDATA%\Cursor\logs\在 Linux 上~/.config/Cursor/logs/身份验证失败症状服务器加载但 API 调用失败并显示“401 未授权”或“无效令牌”。解决方法检查环境变量是否设置正确{mcpServers: {github: {command: npx,args: [-y, modelcontextprotocol/server-github],env: {GITHUB_TOKEN: ${env:GITHUB_TOKEN}}}}}用于${env:VAR_NAME}引用系统环境变量而不是硬编码密钥。如果${env:VAR_NAME}解析结果为空则说明你的 shell 环境未被继承——请在操作系统级别的环境变量中设置该变量Windows 系统属性.zshrcmacOS .bash_profile/Linux 系统 /然后重启 Cursor 以使其应用新值。未找到 npx 命令症状服务器Error: spawn npx ENOENT在 MCP 输出面板中出现故障。修复Cursor 有时无法继承 shell 的 PATH 环境变量尤其是在 macOS 上从图形界面启动时。您可以尝试通过官方安装程序安装 Node.js该程序会设置系统范围的 PATH 环境变量或者在配置文件中使用 npx 的完整路径{mcpServers: {server-name: {command: /usr/local/bin/npx,args: [-y, modelcontextprotocol/server-name]}}}在终端中运行which npxmacOS/Linux或Windows命令即可找到 npx 路径。where npxWindows路径引用问题症状在 Windows 系统上服务器出现故障并出现类似C:\Users\You\AppData\Roaming\npm\npx.cmd is not recognized“路径被空格截断”的错误。修复Windows 系统中包含空格的路径例如 Program Files 文件夹、包含空格的用户文件夹需要进行换行或转义。在 JSON 中反斜杠需要转义{mcpServers: {filesystem: {command: C:\\Program Files\\nodejs\\npx.cmd,args: [-y,modelcontextprotocol/server-filesystem,C:\\Users\\You\\projects\\my-app]}}}在 Windows 系统上使用npx.cmd不要直接使用npx。.cmd扩展名对 spawn 调用很重要。远程服务器连接问题症状基于 HTTP 的 MCP 服务器无法连接ECONNREFUSED或“工具列表超时”。使固定验证服务器是否正在运行且可从同一台机器访问curl http://localhost:3000/mcp应该返回一些内容。检查防火墙规则是否允许通过相关端口建立连接。请确保 URL 包含正确的协议http://本地协议https://远程协议。如果使用 SSE 传输请确认服务器是否真正支持 SSE有些 HTTP 服务器不支持。工具显示但无法运行症状光标列出了 MCP 服务器的工具但调用其中一个工具时返回“工具执行失败”没有具体信息。解决方法检查 MCP 输出面板中的底层堆栈跟踪。最常见的两个原因缺少服务器在工具调用时而不仅仅是启动时所需的必要环境变量env。请在代码块中显式设置该变量。工具尝试访问的文件或套接字权限不足。请使用拥有目标资源的用户身份运行 Cursor或使用 chmod 命令正确设置资源的权限。服务器在会话中途悄无声息地崩溃症状工具在会话开始时运行正常但在会话进行到一半时停止响应。修复某些 MCP 服务器在上游 API 限速时会出现内存泄漏或故障。重启 Cursor 以重新启动服务器进程。要永久修复此问题请向服务器作者提交 issue并通过替换npx -y scope/server为特定版本标签例如npx -y scope/serverversion将替换version为已知可用的版本1.2.3来锁定软件包的已知可用版本。后续步骤扩展您的Cursor MCP 设置从简单的开始配置 Brave 搜索以便立即访问网络添加开发工具GitHub 和数据库服务器可加速编码工作流程探索自动化设置浏览器自动化测试构建自定义服务器请参阅我们的指南了解如何为您的特定 API 和工具构建自定义 MCP 集成。浏览所有选项查看完整的 MCP 服务器列表Cursor MCP 服务器将 IDE 从孤立的编辑器转变为互联的开发环境。您可以先从一台服务器开始验证其价值然后根据工作流程的需求进行扩展。资料来源Cursor MCP 文档模型上下文协议规范如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。
Cursor MCP 服务器完整设置指南
目录什么是Cursor MCP服务器在 Cursor 中设置 MCP 服务器逐步设置方法一手动配置方法二命令面板配置格式Cursor MCP 服务器使用与 Claude Desktop 相同的 JSON 格式对于基于 Python 的 MCP 服务器远程服务器配置最佳 MCP 光标服务器网络搜索与研究GitHub 集成数据库访问浏览器自动化文件操作记忆与知识Cursor 与 Claude Code MCP何时使用Cursor MCP 与 Claude 代码 MCP光标 MCP 在以下情况下会发光Claude Code MCP 在以下情况下表现出色排查 Cursor MCP 服务器故障MCP 工具未在设置中启用服务器未加载无错误身份验证失败未找到 npx 命令Windows路径引用问题远程服务器连接问题工具显示但无法运行服务器在会话中途悄无声息地崩溃后续步骤资料来源如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。在 Cursor IDE 中设置 MCP 服务器。提供分步指南包括故障排除、可用配置以及 Cursor 与 Claude Code 的比较。问题您想使用外部工具和数据源扩展 Cursor但 MCP 配置过程不太清楚。文件应该放在哪里它们使用什么格式它与 Claude Code 相比如何快速入门.cursor/mcp.json在项目根目录下创建一个文件并添加你的第一个 MCP 服务器{mcpServers: {brave-search: {command: npx,args: [-y, modelcontextprotocol/server-brave-search],env: { BRAVE_API_KEY: your-api-key }}}}重启 Cursor 后您现在可以在 IDE 内部使用网络搜索功能。截至 2026 年 5 月经测试本指南中的 Cursor 配置可在 macOS 14、Windows 11 和 Ubuntu 22.04 上使用 0.45 及更高版本。本指南中的所有配置均已在当前 Cursor 稳定版上测试通过。0.45 之前的 Cursor 版本使用不同的设置界面如果您使用的是旧版本请先更新至最新版本再继续操作。什么是Cursor MCP服务器Cursor MCP 服务器通过模型上下文协议将 Cursor 的 AI 与外部工具、数据库和 API 连接起来。由于它们都使用相同的底层协议因此它们与 Claude Code 和 Claude Desktop 中的 MCP 服务器的工作方式完全相同。配置好 MCP 服务器后Cursor 可以搜索网络并获取文档使用自然语言查询数据库与 GitHub、Slack 和其他服务进行交互自动化浏览器测试任务通过 MCP 服务器实现访问任何服务MCP 生态系统在所有兼容工具之间共享。任何与 Claude Desktop 兼容的 MCP 服务器也与 Cursor 兼容。在 Cursor 中设置 MCP 服务器配置文件位置光标支持两个配置位置LocationPathScopeProject-level.cursor/mcp.jsonOnly this projectGlobal~/.cursor/mcp.jsonAll Cursor workspaces对于项目特定的工具例如应用程序的数据库服务器请使用项目级配置。对于需要在所有地方使用的工具例如网络搜索或 GitHub请使用全局配置。逐步设置方法一手动配置.cursor/mcp.json在项目或~/.cursor/mcp.json全局位置创建配置文件。添加您的 MCP 服务器配置重启 Cursor 以加载新服务器测试方法是让 AI 使用你服务器上的工具。方法二命令面板打开命令面板Mac 系统CmdShiftPWindows 系统CtrlShiftP搜索“MCP”然后选择“查看打开MCP设置”。在 MCP 工具下点击“新建 MCP 服务器”。光标创建并打开 mcp.json 文件进行编辑配置格式Cursor MCP 服务器使用与 Claude Desktop 相同的 JSON 格式{mcpServers: {server-name: {command: npx,args: [-y, modelcontextprotocol/server-name],env: {API_KEY: your-key-here}}}}对于基于 Python 的 MCP 服务器{mcpServers: {python-server: {command: python,args: [path/to/server.py],env: {DATABASE_URL: postgresql://localhost/mydb}}}}远程服务器配置Cursor 还支持通过 HTTP 连接远程 MCP 服务器{mcpServers: {remote-server: {url: http://localhost:3000/mcp,headers: {Authorization: Bearer your-token}}}}这使得可以连接到运行在远程计算机上或作为共享服务运行的 MCP 服务器。Cursor 的 HTTP 和 SSE 传输协议会自动处理重新连接如果远程服务器重启Cursor 会在下次调用该工具时重新连接。最佳 MCP 光标服务器这些 Cursor MCP 服务器提供最强大的功能。所有配置均可直接在您的系统中运行.cursor/mcp.json。以下每个条目都显示了配置及其在您的日常工作流程中实际解锁的功能。网络搜索与研究{mcpServers: {brave-search: {command: npx,args: [-y, modelcontextprotocol/server-brave-search],env: { BRAVE_API_KEY: your-key }}}}您可以这样做在对话过程中让 Cursor 查找当前的 API 文档查找 Stack Overflow 上关于晦涩错误的讨论帖或者在不离开编辑器的情况下获取依赖项的最新变更日志。GitHub 集成{mcpServers: {github: {command: npx,args: [-y, modelcontextprotocol/server-github],env: { GITHUB_TOKEN: your-token }}}}您可以执行以下操作打开和分类问题、评论拉取请求、从另一个分支获取差异以供审查或者从最近 20 个合并的 PR 生成发行说明而无需切换到 GitHub UI。数据库访问{mcpServers: {postgres: {command: npx,args: [-y, modelcontextprotocol/server-postgres],env: { DATABASE_URL: postgresql://user:passlocalhost/db }}}}您可以执行以下操作让 Cursor 检查您的模式针对真实表编写查询运行 EXPLAIN ANALYZE并针对您的开发数据库副本调试失败的迁移。浏览器自动化{mcpServers: {playwright: {command: npx,args: [-y, executeautomation/playwright-mcp-server]}}}您可以这样做让 Cursor 打开一个页面点击完成一个流程截取结果屏幕截图然后编写一个 Playwright 测试来重现这些步骤。有关高级模式请参阅浏览器自动化指南。文件操作{mcpServers: {filesystem: {command: npx,args: [-y,modelcontextprotocol/server-filesystem,/path/to/allowed/directory]}}}您可以执行以下操作赋予 Cursor 对打开的工作区之外的目录的读/写权限——这对于跨仓库重构或在不打开同级项目的情况下从同级项目拉取资源非常有用。记忆与知识{mcpServers: {memory: {command: npx,args: [-y, modelcontextprotocol/server-memory]}}}您可以执行以下操作将项目决策、术语表术语或架构注释在 Cursor 会话中保存到知识图谱中以便 AI 稍后可以查询。浏览我们的完整 MCP 服务器列表了解 50 多个其他选项。Cursor 用户需要注意两款值得关注的供应商 MCPShopify AI Toolkit和Higgsfield MCP都支持 Cursor 的.cursor/mcp.json配置格式无需修改即可使用。如果您已经在使用 Claude Code 运行这些 MCP则可以直接复制相同的配置块。Cursor 与 Claude Code MCPCursor 和 Claude Code 都使用相同的模型上下文协议因此服务器包可以互换。区别在于传输方式、配置的易用性和上下文处理。FeatureCursorClaude CodeConfig location.cursor/mcp.json~/.claude.jsonor.mcp.jsonTransport typesstdio, SSE, HTTPstdio (HTTP/SSE in some preview builds)OAuth supportBuilt-in OAuth flow with browser-handled authManual token paste inenvblockTool searchNot available — all tools loaded at session startTool Search — lazy loading on demandResourcesNot yet supportedSupportedHot reloadRestart Cursor required for config changesReloads on.mcp.jsonedit in some buildsPer-project scope.cursor/mcp.jsonper projectProject-level.mcp.jsonworks the same way何时使用Cursor MCP 与 Claude 代码 MCP这两个工具针对不同的工作流程进行了优化。光标 MCP 在以下情况下会发光您需要完整的 IDE 功能多光标编辑、内联建议、重构菜单以及 MCP 驱动的 AI。您的团队已经统一使用 Cursor现在您想在不更换 IDE 的情况下集成 MCP。您需要使用支持 OAuth 认证的服务例如 GitHub、Notion、Linear并且不想手动管理 API 令牌。您的 MCP 服务器数量很少启动时全部负载的开销无关紧要。Claude Code MCP 在以下情况下表现出色你正在终端中工作想要一个更精简、更快速的上下文循环您有很多 MCP 服务器需要工具搜索延迟加载以保持上下文精简Cursor 在启动时全部加载的成本在超过约 10 台服务器后会迅速增加。您正在协调多代理或多会话工作流程在这种情况下终端比集成开发环境 (IDE) 更合适。您需要资源支持对模型提供只读文件/数据访问权限以便在不调用工具的情况下进行接地。一个实用的模式是许多开发者同时运行这两个工具。Cursor 处理那些与 IDE 紧密相关的工作例如需要内联建议和重构的操作。Claude Code 则处理长时间运行的编排、批量重构以及任何涉及多个 MCP 服务器的会话。两者都支持相同的服务器软件包。为 Claude Desktop 配置的服务器可以在 Cursor 中运行反之亦然。这种可移植性值得注意如果您使用像ClaudeFast 的 Code Kit这样的入门套件搭配 Claude Code那么它提供的 MCP 配置只需进行少量调整即可应用到 Cursor 项目中。排查 Cursor MCP 服务器故障以下是出现频率最高的故障模式、它们产生的实际错误消息以及有效的修复方法。MCP 工具未在设置中启用症状您已向 添加了服务器.cursor/mcp.json并重新启动了 Cursor但 AI 显示没有可用工具。可能原因光标的 MCP 功能被限制在一个设置开关后面该开关在某些安装中默认处于关闭状态。解决方法打开 Cursor 设置Cmd/Ctrl ,搜索“MCP”并确认“启用 MCP 服务器”已勾选。然后重启 Cursor。在命令面板中运行命令MCP: View Server Status以确认服务器已加载。服务器未加载无错误症状MCP 服务器未出现在可用工具中没有明显的错误。使固定请验证 JSON 语法是否有效不能有尾随逗号也不能有注释——JSON 不支持这两种格式。彻底重启 Cursor 程序退出并重新启动而不仅仅是重新加载窗口检查“输出”面板查看 输出 从下拉菜单中选择“MCP”以查看加载错误在 macOS 上检查~/Library/Logs/Cursor/文件mcp-*.log在 Windows 上%APPDATA%\Cursor\logs\在 Linux 上~/.config/Cursor/logs/身份验证失败症状服务器加载但 API 调用失败并显示“401 未授权”或“无效令牌”。解决方法检查环境变量是否设置正确{mcpServers: {github: {command: npx,args: [-y, modelcontextprotocol/server-github],env: {GITHUB_TOKEN: ${env:GITHUB_TOKEN}}}}}用于${env:VAR_NAME}引用系统环境变量而不是硬编码密钥。如果${env:VAR_NAME}解析结果为空则说明你的 shell 环境未被继承——请在操作系统级别的环境变量中设置该变量Windows 系统属性.zshrcmacOS .bash_profile/Linux 系统 /然后重启 Cursor 以使其应用新值。未找到 npx 命令症状服务器Error: spawn npx ENOENT在 MCP 输出面板中出现故障。修复Cursor 有时无法继承 shell 的 PATH 环境变量尤其是在 macOS 上从图形界面启动时。您可以尝试通过官方安装程序安装 Node.js该程序会设置系统范围的 PATH 环境变量或者在配置文件中使用 npx 的完整路径{mcpServers: {server-name: {command: /usr/local/bin/npx,args: [-y, modelcontextprotocol/server-name]}}}在终端中运行which npxmacOS/Linux或Windows命令即可找到 npx 路径。where npxWindows路径引用问题症状在 Windows 系统上服务器出现故障并出现类似C:\Users\You\AppData\Roaming\npm\npx.cmd is not recognized“路径被空格截断”的错误。修复Windows 系统中包含空格的路径例如 Program Files 文件夹、包含空格的用户文件夹需要进行换行或转义。在 JSON 中反斜杠需要转义{mcpServers: {filesystem: {command: C:\\Program Files\\nodejs\\npx.cmd,args: [-y,modelcontextprotocol/server-filesystem,C:\\Users\\You\\projects\\my-app]}}}在 Windows 系统上使用npx.cmd不要直接使用npx。.cmd扩展名对 spawn 调用很重要。远程服务器连接问题症状基于 HTTP 的 MCP 服务器无法连接ECONNREFUSED或“工具列表超时”。使固定验证服务器是否正在运行且可从同一台机器访问curl http://localhost:3000/mcp应该返回一些内容。检查防火墙规则是否允许通过相关端口建立连接。请确保 URL 包含正确的协议http://本地协议https://远程协议。如果使用 SSE 传输请确认服务器是否真正支持 SSE有些 HTTP 服务器不支持。工具显示但无法运行症状光标列出了 MCP 服务器的工具但调用其中一个工具时返回“工具执行失败”没有具体信息。解决方法检查 MCP 输出面板中的底层堆栈跟踪。最常见的两个原因缺少服务器在工具调用时而不仅仅是启动时所需的必要环境变量env。请在代码块中显式设置该变量。工具尝试访问的文件或套接字权限不足。请使用拥有目标资源的用户身份运行 Cursor或使用 chmod 命令正确设置资源的权限。服务器在会话中途悄无声息地崩溃症状工具在会话开始时运行正常但在会话进行到一半时停止响应。修复某些 MCP 服务器在上游 API 限速时会出现内存泄漏或故障。重启 Cursor 以重新启动服务器进程。要永久修复此问题请向服务器作者提交 issue并通过替换npx -y scope/server为特定版本标签例如npx -y scope/serverversion将替换version为已知可用的版本1.2.3来锁定软件包的已知可用版本。后续步骤扩展您的Cursor MCP 设置从简单的开始配置 Brave 搜索以便立即访问网络添加开发工具GitHub 和数据库服务器可加速编码工作流程探索自动化设置浏览器自动化测试构建自定义服务器请参阅我们的指南了解如何为您的特定 API 和工具构建自定义 MCP 集成。浏览所有选项查看完整的 MCP 服务器列表Cursor MCP 服务器将 IDE 从孤立的编辑器转变为互联的开发环境。您可以先从一台服务器开始验证其价值然后根据工作流程的需求进行扩展。资料来源Cursor MCP 文档模型上下文协议规范如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。
