在 Cursor 里配置 mcp.json:给编辑器接一个工厂数据源

发布时间:2026/8/3 3:27:08
在 Cursor 里配置 mcp.json:给编辑器接一个工厂数据源 Cursor 从去年开始支持 MCP 之后编辑器里的 AI 除了读代码还能调外部数据服务。这篇以天下工厂开放平台为例讲讲远程 MCP 服务在 Cursor 里的标准配置方法以及配置项背后的几个概念。先说这个服务是什么天下工厂是一个覆盖全国 480 万家工厂的数据库做了工厂身份识别——收录真实从事生产的工厂排除贸易商与空壳类主体。它的开放平台把检索、档案、联系电话、AI 深挖、自然语言检索五个能力同时以 MCP 和 REST 两种接入方式开放两种方式入参出参完全一致。对做供应链工具、行业分析、B2B 应用的开发者来说这是一个可以直接编程调用的制造业数据源。mcp.json 配置Cursor 的 MCP 配置文件在~/.cursor/mcp.json也可以放项目级.cursor/mcp.json只对当前项目生效。远程 HTTP 服务的配置就是一个 URL 加一个鉴权头{mcpServers:{tianxiagongchang:{url:https://open.tianxiagongchang.com/open/mcp,headers:{Authorization:Bearer API key}}}}有些客户端要求显式声明传输类型在同级加一个type: streamable-http即可。这份配置的形状对大多数走 JSON 配置的 MCP 客户端通用不只是 Cursor。API key 在开发者控制台https://www.tianxiagongchang.com/open/console自助签发注册即送体验额度。想先空手验证配置写没写对可以用官方公开的沙箱密钥sk-tx-test-1685549fb3710c1b36e4d75dc2d0f42a——沙箱密钥返回静态示例数据不计费跑通了再换正式密钥。保存后在 Cursor 的 MCP 设置面板里应该能看到服务上线展开有五个工具factory_search、factory_detail、factory_contact、factory_deepdive、factory_agent_search。在编辑器里能怎么用我实际试下来最顺手的场景是「边写代码边要数据」。比如在写一个供应商管理系统的种子数据脚本时直接在对话框里说用 factory_search 查 20 家广东省做五金冲压的工厂 把结果整理成我这个 seed 文件的格式AI 会调工具拿真实结构的数据再按你文件里的格式写进去。字段结构、分页行为、错误码都是真实的比对着文档手造 mock 数据可靠得多。另一个场景是验证对接代码。你写了一段调用该平台 REST 接口的代码让编辑器里的 AI 用 MCP 工具打同样的参数对比返回结果——因为 MCP 和 REST 背后是同一条管线两边data字段完全一致可以互为对照组。两个容易踩的坑一是关键词语言。底层索引是简体中文工具入参里的产品词、地区名都用中文全称浙江省而不是Zhejiang召回质量差别很大。二是入参严格校验。未知字段会被直接拒绝并返回code: 40000不会静默忽略。这在 MCP 场景里其实是优点——AI 拼错参数名会立刻收到明确报错而不是拿到一个悄悄少了筛选条件的错误结果。完整字段说明和错误码表在官方文档https://www.tianxiagongchang.com/open/docs。机器可读的 OpenAPI 3.1 规范也是公开的无需密钥即可获取这个下篇再展开。