1. 项目概述一个为 Cursor AI 用户打造的“百宝箱”如果你和我一样日常重度依赖 Cursor 这款 AI 驱动的代码编辑器那你肯定遇到过这样的场景想快速接入一个外部数据源比如查查 AWS 文档或者调用下 Stripe 的 API但面对 Model Context Protocol 的配置总得去翻文档、写 JSON过程略显繁琐。今天要聊的这个开源项目colesmcintosh/cursor-solutions就是来解决这个痛点的。它本质上是一个社区驱动的网站核心目标是为所有 Cursor AI 用户提供一个集中式的资源、工具和解决方案平台。你可以把它理解成一个专为 Cursor 生态打造的“应用商店”或“工具集散地”目前最亮眼的功能就是一个能让你点点鼠标就生成mcp.json配置文件的构建工具。这个项目完全开源采用 MIT 许可证意味着你可以自由地使用、修改甚至部署属于你自己的版本。它的出现反映了 Cursor 社区正在从单纯的使用工具向构建和分享工具生态演进这对于提升我们整体的开发效率有着实实在在的价值。无论你是刚接触 Cursor 和 MCP 的新手还是已经折腾过不少配置的老手这个项目都能提供即时的帮助让你把更多精力放在创造性的编码上而不是繁琐的配置上。2. 核心功能深度解析MCP.json 构建器2.1 MCP 是什么以及为什么需要这个构建器在深入这个工具之前我们得先搞清楚 MCP 是什么。Model Context Protocol你可以把它想象成 Cursor AI 的“外接大脑”或“插件系统”。默认情况下Cursor 的 AI 模型比如 Claude只能基于你当前项目文件和它自身的知识来回答问题。但通过 MCP你可以让 AI 连接到各种外部数据源和服务比如公司的内部文档库、生产数据库、第三方 API如 GitHub、Slack甚至搜索引擎。这样当你问 AI “我们项目的上周错误日志趋势是怎样的”或者“帮我在 Stripe 里创建一个新的订阅产品”时它就能调用对应的 MCP 服务器去获取实时数据或执行操作给出更精准、更具行动力的回答。而连接这些“外接大脑”的关键就是一个名为mcp.json的配置文件。这个文件需要放置在 Cursor 的配置目录下它定义了 AI 可以访问哪些服务器、每个服务器的具体地址、所需的认证信息等。手动编写这个 JSON 文件虽然不复杂但难免会遇到格式错误、参数遗漏或者需要反复查阅不同服务器文档的麻烦。cursor.solutions网站上的 MCP.json 构建器正是为了消除这个摩擦点而生的。它通过一个直观的 Web 界面将配置过程从“手写代码”变成了“可视化点选”大幅降低了使用门槛也减少了出错概率。2.2 构建器的核心工作机制与可用服务器盘点这个构建器的工作原理非常直接。前端页面会展示一个预置的、持续更新的 MCP 服务器列表。每个服务器选项通常包含服务器名称、简要描述有时还会有配置参数的输入框比如 API 密钥、服务器地址等。当你勾选需要的服务器并填写必要的参数后点击生成按钮前端 JavaScript 会动态地将你的选择组装成一个符合 MCP 协议规范的 JSON 对象。最后提供下载功能将这个 JSON 对象保存为mcp.json文件你只需要将它放到正确的位置即可。根据项目描述目前集成的服务器已经相当丰富覆盖了多个常用场景云服务与数据AWS KB Retrieval用于查询 AWS 知识库、NeonServerless Postgres 服务。搜索与地图Brave Search、Google Maps。开发与协作GitHub、Slack。支付与商业Stripe。以及“更多”暗示社区在不断贡献新的服务器集成。这个列表本身就是一份极有价值的“MCP 服务器精选目录”。对于新手它指明了有哪些现成的、好用的工具可以尝试对于老手也能快速发现可能遗漏的、能提升效率的新集成。注意构建器生成的mcp.json文件通常只包含服务器的基础配置框架。对于一些需要认证如 API Key的服务器你可能需要在生成的 JSON 中手动补充这些敏感信息或者按照工具的指引在输入框中填写。切勿将包含真实密钥的配置文件提交到公开版本库。2.3 超越构建器项目的平台化愿景虽然当前版本的焦点是 MCP.json 构建器但项目的名称“cursor.solutions”和其“An open source everything website for Cursor AI”的定位暗示了更大的野心。它不仅仅想做一个工具更想成为一个平台。未来这里完全有可能发展出以下内容解决方案库分享针对特定开发场景如“全栈 React Node.js 项目启动”、“调试一个 Kubernetes 部署问题”的最佳 Cursor 使用范例和对话提示词。插件/脚本市场社区成员可以提交自己编写的 Cursor 相关脚本、工作流或主题。教程与指南结构化的学习路径教用户如何最大限度地利用 Cursor 和 MCP。服务器贡献指南简化社区成员提交新 MCP 服务器集成到该工具的过程。这种平台化思路使得项目的价值不仅在于其当前提供的工具更在于其作为社区枢纽的潜力能够持续汇聚和分发来自全球 Cursor 用户的智慧。3. 本地开发与部署实操指南3.1 环境准备与项目结构初探要运行或贡献这个项目准备非常简单。正如项目所述核心需求就是一个现代网页浏览器和一个你顺手的 IDE如 VS Code、WebStorm。项目本身是纯前端技术栈这意味着它由 HTML、CSS 和 JavaScript 构成没有后端服务器依赖这也正是它能通过 GitHub Pages 之类服务轻松部署的原因。将项目克隆到本地后我们来看看它的典型结构git clone https://github.com/colesmcintosh/cursor-solutions.git cd cursor-solutions你会看到一个类似如下的目录结构具体可能随版本变化cursor-solutions/ ├── index.html # 网站主入口文件 ├── style.css # 主要样式表 ├── script.js # 核心交互逻辑包括 MCP 构建器 ├── servers.json # 或类似文件存储可用的 MCP 服务器列表和配置模板 ├── assets/ # 存放图片、图标等静态资源 ├── README.md # 项目说明文档 └── LICENSE # MIT 许可证文件servers.json是这个项目的“数据引擎”。它很可能是一个 JSON 数组其中每个对象定义了一个 MCP 服务器的名称、描述、官方文档链接、以及生成mcp.json时所需的配置模板。理解这个文件的结构对于想要添加新服务器支持的贡献者至关重要。3.2 两种本地运行方式详解项目提供了两种本地运行方式适用于不同场景。方式一使用 IDE 配合 Live Server强烈推荐这是开发时的标准做法。以 VS Code 为例用 VS Code 打开克隆下来的cursor-solutions文件夹。在扩展市场搜索并安装 “Live Server” 扩展由 Ritwick Dey 开发。安装完成后你会在 VS Code 右下角状态栏看到一个 “Go Live” 按钮或者在项目根目录的index.html文件上右键选择 “Open with Live Server”。点击后你的默认浏览器会自动打开http://localhost:5500或类似端口并显示网站。最关键的是Live Server 提供了热重载功能。当你修改了 HTML、CSS 或 JS 文件并保存时浏览器页面会自动刷新无需你手动操作。这能极大提升开发和调试效率。方式二直接浏览器打开文件你也可以直接双击index.html文件或用浏览器菜单的“打开文件”功能加载它。这种方式能快速查看页面渲染效果。但有一个重要限制由于浏览器的同源策略安全限制如果页面中的 JavaScript 尝试通过fetch或XMLHttpRequest加载本地的servers.json等数据文件可能会失败并报跨域错误。因此这种方式无法保证MCP 构建器等依赖动态数据加载的功能正常工作。它仅适用于快速检查静态 HTML 结构。实操心得在开发涉及本地数据文件读取的前端项目时永远使用一个本地开发服务器如 Live Server、http-server、python -m http.server。这能模拟真实的网络请求环境避免同源策略带来的坑。Live Server 是零配置的最佳选择。3.3 从开发到部署让网站上线由于项目是纯静态网站部署变得异常简单。你可以选择多种免费或付费的托管服务GitHub Pages最便捷将你的代码推送到 GitHub 仓库。在仓库设置中找到 “Pages” 选项。选择部署分支通常是main或master和根目录/root。保存后GitHub 会自动构建并部署你的网站并提供https://你的用户名.github.io/仓库名的访问地址。这是参与开源贡献后展示自己 Fork 版本的最佳方式。Vercel / Netlify更强大将仓库与 Vercel 或 Netlify 账户关联。这些平台会自动检测为静态网站项目几乎无需配置。它们能提供自定义域名、自动 HTTPS、更快的全球 CDN 以及预览部署等功能适合用于更正式的发布。传统虚拟主机/对象存储只需将index.html、style.css、script.js等所有文件上传到服务器的 Web 根目录如/var/www/html或 AWS S3、Cloudflare R2 等对象存储桶并设置为静态网站托管即可。部署后全球的 Cursor 用户就都能访问到你搭建的这个工具站了。4. 为项目添砖加瓦贡献指南详解4.1 标准的 Git 工作流项目采用了经典的 GitHub 协作流程这也是大多数开源项目的标准做法。如果你想修复一个 bug 或添加一个新功能请遵循以下步骤Fork 仓库在 GitHub 上点击项目页面的 “Fork” 按钮。这会在你的个人账户下创建一个完全独立的副本。克隆你的 Fork将你账户下的仓库克隆到本地。git clone https://github.com/你的用户名/cursor-solutions.git cd cursor-solutions创建功能分支永远不要在main分支上直接修改。为每个新任务创建一个描述性的分支。git checkout -b feat/add-jira-mcp-server # 或 fix/typo-in-readme, docs/update-contributing-guide进行修改并提交完成你的代码或文档更改后使用“约定式提交”来提交。git add . git commit -m feat: add Jira MCP server configuration to builder # 常见的类型前缀feat新功能、fix修复、docs文档、style格式、refactor重构、test测试、chore构建/工具推送到你的 Forkgit push origin feat/add-jira-mcp-server发起 Pull Request (PR)在你的 Fork 仓库页面GitHub 通常会提示你为新分支创建 PR。点击后选择将你的分支合并到原项目colesmcintosh/cursor-solutions的main分支。在 PR 描述中清晰说明你的修改内容、动机以及测试情况。4.2 如何贡献一个新的 MCP 服务器这是对项目最有价值的贡献之一。假设你想添加一个 “Jira” MCP 服务器到构建器中你需要做两件事第一理解servers.json的数据结构。你需要研究项目中的servers.json文件或类似的数据源文件。它的结构可能类似于[ { id: github, name: GitHub, description: Access GitHub repositories, issues, and pull requests., configTemplate: { mcpServers: { github: { command: npx, args: [-y, modelcontextprotocol/server-github], env: { GITHUB_TOKEN: {{YOUR_GITHUB_TOKEN}} } } } } }, // ... 其他服务器 ]你需要为 Jira 服务器创建一个新的配置对象其中configTemplate是关键它定义了最终生成mcp.json的片段。第二修改构建器的前端逻辑如果需要。如果构建器的 UI 是硬编码的服务器列表你可能还需要修改index.html或script.js将新的 Jira 服务器选项添加到勾选列表中。如果 UI 是动态从servers.json加载的那么你只需要更新数据文件即可。在提交 PR 前务必在本地测试更新servers.json和前端代码。使用 Live Server 运行网站。在界面上找到并勾选你新加的 “Jira” 选项。点击生成检查下载的mcp.json文件内容是否正确是否符合 MCP 官方协议。最好能附上测试截图或屏幕录制证明功能正常工作。4.3 除了代码你还能贡献什么开源贡献远不止写代码。对于cursor.solutions这样的项目以下贡献同样宝贵文档改进README.md让它对新手更友好。为现有的 MCP 构建器功能编写更详细的使用教程。翻译文档成其他语言。设计优化网站的 UI/UX让它更美观、易用。提供不同颜色的主题。测试试用网站的所有功能报告你发现的 bug 或体验不佳的地方。测试在不同浏览器Chrome, Firefox, Safari, Edge下的兼容性。内容如果你有使用某个特定 MCP 服务器的经验可以撰写一篇短文分享配置技巧和使用案例项目可以开辟一个“博客”或“案例研究”板块来收纳这些内容。推广如果你觉得这个项目有用在社交媒体、技术社区或向你的同事分享它让更多人受益。5. 常见问题与实战排错记录5.1 构建器使用相关问题Q1: 我生成了mcp.json文件应该放在哪里A1: 这取决于你的操作系统和 Cursor 的安装方式。通常路径如下macOS / Linux:~/.cursor/mcp.jsonWindows:%USERPROFILE%\.cursor\mcp.json将下载的mcp.json文件放置到这个目录下。如果.cursor目录不存在可以手动创建。放置后通常需要重启 Cursor才能使新的 MCP 配置生效。Q2: 为什么我配置了 MCP 服务器但在 Cursor 里跟 AI 对话时它还是说无法访问A2: 这是一个多因素问题请按顺序排查路径与重启确认文件位置绝对正确并且已经重启了 Cursor。配置文件语法用 JSON 校验工具如 JSONLint 检查你下载的mcp.json文件是否有格式错误。构建器通常不会出错但如果你手动编辑过就可能引入错误。服务器依赖许多 MCP 服务器尤其是通过npx运行的需要在你的系统上安装 Node.js。确保你已安装 Node.js 且版本符合要求。你可以在终端尝试运行配置文件中command指定的命令如npx -y modelcontextprotocol/server-github看是否能正常启动这能排除环境问题。认证信息检查配置文件中需要 API Token、密钥等环境变量的部分如env字段。你是否在系统的环境变量中正确设置了它们或者在 Cursor 的上下文中这些变量是否可读Cursor 版本确保你使用的是支持 MCP 的 Cursor 版本。较旧的版本可能不支持此功能。Q3: 构建器里的服务器列表不全我想用的 XXX 服务没有怎么办A3: 这正是开源社区的价值所在你有两个选择发起 Issue在项目的 GitHub 仓库中创建一个新的 Issue标题可以是 “Request: Add MCP server for XXX”描述一下这个服务器的用途和潜在价值。这能引起维护者和其他社区成员的注意。直接贡献如果你有技术能力可以按照前面“贡献指南”的步骤研究该服务的 MCP 服务器是否存在通常搜索 “MCP server for XXX”然后将其添加到项目的servers.json和前端列表中并提交 Pull Request。5.2 开发与贡献相关问题Q4: 我在本地运行但构建器页面是空的或者控制台有跨域错误。A4: 这几乎可以确定你使用了“直接浏览器打开文件”的方式。请切换到使用Live Server扩展来运行项目。如果使用 Live Server 后问题依旧请打开浏览器的开发者工具F12查看“网络”选项卡确认servers.json或其他资源文件是否成功加载状态码应为 200。如果加载失败检查文件路径是否正确以及 Live Server 是否从项目根目录启动。Q5: 我想修改网站样式但 CSS 改动后 Live Server 刷新了却看不到效果。A5: 浏览器可能会缓存旧的 CSS 文件。尝试以下方法在开发者工具中打开“网络”选项卡勾选“禁用缓存”。执行强制刷新Ctrl F5(Windows/Linux) 或Cmd Shift R(Mac)。检查你的 CSS 选择器优先级是否被原有的样式覆盖。使用开发者工具的“元素”面板检查目标元素应用的最终样式并确认你的新规则是否生效。Q6: 我提交了一个 Pull Request但 CI持续集成检查失败了怎么办A6: 首先仔细阅读 CI 失败的具体信息通常在 PR 页面底部有 Details 链接。常见的失败原因包括代码风格/格式化问题项目可能使用了 Prettier 或 ESLint 等工具。你需要在本地运行npm run format或npm run lint如果项目有相关脚本来修复格式问题然后重新提交。测试失败如果你修改了核心逻辑可能需要补充或更新相应的测试用例。构建失败检查你的修改是否引入了语法错误导致项目无法构建。 根据错误信息进行修复然后将更改推送到你的分支PR 会自动更新并重新运行 CI。5.3 项目理解与扩展思考Q7: 这个项目和官方的 Cursor 文档或 MCP 注册表是什么关系A7: 这是一个很好的问题。cursor.solutions是一个社区驱动的补充资源而非官方渠道。官方文档提供最权威、最基础的协议说明和用法指南。MCP 注册表可能是一个列出所有已知 MCP 服务器包的地方。cursor.solutions它的价值在于整合与简化。它从众多服务器中筛选出常用、好用的部分并通过一个零代码的图形化工具将配置流程打包成一个“开箱即用”的体验。它更注重终端用户的直接可用性降低了从“知道有这个东西”到“真正用起来”之间的障碍。Q8: 我能否基于这个项目搭建一个我们公司内部使用的、集成私有 MCP 服务器的工具站A8:完全可以而且这是一个非常棒的想法这正是开源项目的魅力所在。你可以 Fork 这个项目然后进行定制在servers.json中移除所有公开服务器添加你们公司内部的 MCP 服务器配置例如连接内部知识库、项目管理系统、监控系统的服务器。修改前端页面替换 Logo、标题和描述使其符合公司内部品牌。将定制后的网站部署到公司的内网环境中。 这样你们团队的成员就可以通过这个内部工具站一键生成符合公司技术栈的mcp.json配置文件极大提升内部工具的使用效率和一致性。记得遵守项目的 MIT 许可证要求通常只需保留原许可证文件即可。