NeuronForm 3D map models

NeuronForm MCP 服务

NeuronForm 可将 OpenStreetMap 数据转换为可直接打印的多色 3D 地图模型。其公开 MCP 服务可让 Claude 或 ChatGPT 等 AI 助手通过聊天设计这些模型：查找地点、创建和修改设计、将设计显示为图像；如果聊天界面支持，还可显示可旋转的 3D 视图，并向用户提供一个链接，点击后即可在 NeuronForm 配置器中打开对应的设计。

本仓库包含服务文档、附有相应提示词的示例需求，以及用于 MCP 注册表的 server.json。其中不包含 NeuronForm 服务的代码。

德语版本：Deutsch。网站：neuronform.com/agents/en。

MCP 地址

https://neuronform.com/mcp

项目	值
传输方式	Streamable HTTP，无状态（每个请求返回一个 JSON 响应，无会话）
Accept 标头	application/json、application/json, text/event-stream、*/* 或不设置：每个 POST 请求都会收到一个 JSON 响应；仅接受 text/event-stream 的请求会收到 HTTP 406
请求正文	最大 2 MiB；超过此大小的请求会在任何工具运行前收到 HTTP 413
身份验证	无；无需账户或 API 密钥
费用	免费
服务名称	NeuronForm，标题为“NeuronForm 3D map models”
MCP Apps	扩展 io.modelcontextprotocol/ui；3D 查看器是资源 ui://neuronform/viewer
资源	查看器、设计架构 neuronform://schema/design，以及 get_design_guide 每个主题对应的指南 neuronform://guide/{topic}

Agent 不会导出打印文件，也不会购买。导出和购买仅可在配置器中进行，并使用用户自己的 NeuronForm 账户。

设置

Claude（claude.ai、桌面和移动应用）

所有 Claude 套餐均可使用自定义连接器；免费套餐可添加一个。

1. 打开“Customize” › “Connectors”。
2. 选择“+ Add”，然后选择“Add custom connector”。
3. 输入名称 NeuronForm 和 MCP 地址，然后选择“Continue”。
4. 检查检测到的身份验证设置，然后选择“Continue”。
5. 在“Authentication”下，选择“No sign in”。
6. 选择“Add”。

在聊天中，通过“+” › “Connectors”启用连接器。在 Team 和 Enterprise 组织中，组织所有者可通过“Organization settings” › “Connectors”中的“Add” › “Custom” › “Web”添加连接器，成员则可通过“Customize” › “Connectors”中的“Connect”连接该连接器。来源：Anthropic 关于自定义连接器的帮助文章。

ChatGPT

能否添加自己的 MCP 服务，取决于 ChatGPT 套餐；在工作区中，还取决于工作区的权限和安全设置。

1. 在网页版 ChatGPT 中打开 ChatGPT 插件。
2. 选择加号按钮，然后选择“Add custom MCP server”。
3. 输入名称 NeuronForm，也可以选择输入简短描述。
4. 在“Connection”下，选择公共端点并输入 MCP 地址。
5. 选择“No authentication”，查看风险警告，然后选择“I understand and want to continue”。
6. 选择“Create as a plugin”，查看服务列出的工具，然后安装插件。

在新对话中输入 @，然后选择 NeuronForm。OpenAI 有时会更改这些标签；当前步骤请参阅其开发者文档。

Claude Code

claude mcp add --transport http neuronform https://neuronform.com/mcp

使用 --scope project 时，该条目会写入项目的 .mcp.json。

Cursor

项目中的 .cursor/mcp.json，或适用于所有项目的 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "neuronform": {
      "url": "https://neuronform.com/mcp"
    }
  }
}

VS Code

在命令面板中运行“MCP: Add Server”，选择“HTTP（HTTP 或 Server-Sent Events）”，输入 MCP 地址和服务 ID neuronform， 然后选择一个目标位置：

• “Global” › “Copilot Global”会为每个 工作区写入 ~/.copilot/mcp-config.json，或者在设置了 COPILOT_HOME 时写入 $COPILOT_HOME/mcp-config.json。
• 工作区根目录下的 .mcp.json 可与团队共享服务； 引导流程会在启用实验性设置 chat.mcp.workspaceRootConfig.enabled 后提供此选项。
• 工作区中的 .vscode/mcp.json，引导流程将其标记为 已弃用。

.vscode/mcp.json 中的条目：

{
  "servers": {
    "neuronform": {
      "type": "http",
      "url": "https://neuronform.com/mcp"
    }
  }
}

可移植文件 ~/.copilot/mcp-config.json 和 .mcp.json 在 mcpServers 下列出相同的 条目，而不是在 servers 下。Microsoft 在其 VS Code 中 MCP 服务的文档中介绍了这些目标位置。

其他客户端

通过 Streamable HTTP 连接远程 MCP 服务的每个客户端只需要 MCP 地址。

工具

每个工具都接受可选参数 lang（de 或 en，默认为 en）。 它用于设置摘要、通知以及错误消息开头句和提示的语言；指南文本和 设计验证的详情文本为英文。调用成功时，会返回一个文本块，其中包含简短 摘要，后接 JSON 结果；同一结果也会作为 structuredContent 返回；render_design 会在文本块之前返回 JPEG 图像，而 get_design_guide 的 文本块包含指南文本。调用失败时，会返回 isError: true，并附带可执行的消息；在 structuredContent 中会包含 message 和 errors 列表，每个被拒绝的字段对应一项（field、message、hint）；未知工具名称会导致 JSON-RPC 错误。design 参数是完整的设计 JSON；其架构为资源 neuronform://schema/design。

工具	用途	主要参数	只读
search_places	在服务的地点目录中搜索地点、街道和门牌号；返回每个候选项的名称、纬度、经度和类型	query（2 到 200 个字符）、limit（1 到 10，默认值为 5）	是
create_design	使用配置器默认值，将简短的设计简介编译为完整设计；无效值会回退到默认值，并显示注明简介字段的提示	brief	是
edit_design	使用简介字段（changes）和 JSON Patch 操作 add、replace、remove（patch，最多 100 项，在 changes 之后应用）修改设计，并返回修改后的设计；必须提供其中至少一项；服务不存储设计，因此每次调用都必须携带完整设计	design、changes、patch	是
get_design_guide	说明设计 JSON 中某个主题的内容，并提供其字段的 JSON 架构	topic（默认值为 overview）	是
find_map_elements	列出设计中位于交叉口之间的道路、路径、铁路和水道路段（line）、建筑物、区域或地面区域，并提供可直接插入的片段及其目标路径；片段使用颜色 D8493F，建筑物片段还包含自定义房屋的位置，该房屋会替换原建筑物	design、kind（line、building、area、ground）、name、class、near（lat、lon）、limit（1 到 50，默认值为 10）、tile	是
edit_tiles	在某块地图瓦片的罗盘方位一侧添加瓦片，或移除该处的瓦片，并返回修改后的设计；瓦片 0 始终保留	design、action（add、remove）、tile（默认值为 0）、direction（n、ne、e、se、s、sw、w、nw）	是
validate_design	根据请求规则、匿名使用限制和受限区域检查设计，但不生成设计；列出每块瓦片的中心及其空闲边缘，并列出每栋自定义房屋的打印尺寸及其打印尺寸未包含的细节	design	是
render_design	渲染一张 1600 × 800 像素的 JPEG，包含北、东、南、西四个视角及俯视图；或者渲染一张 800 × 800 像素的单视图图像（view 为 top，或 oblique 并设置 direction，默认值为 sw）；将 resolution 设为 high 时，宽度和高度均加倍；返回包含尺寸、三角形、颜色组、警告和瓦片位置的摘要、署名信息及查看器链接，并在支持 MCP Apps 或 ChatGPT apps 的宿主中打开 3D 查看器	design、view（overview、top、oblique；默认值为 overview）、direction、resolution（standard、high）	是
share_design	将设计存储为匿名快照，并返回一个有效期为 90 天的链接，可在配置器中打开该快照	design	否（创建快照，不删除任何内容）
list_templates	列出最多 50 个已发布的图库模板，包含 slug、标题、描述、瓦片数量和图片 URL；提供 slug 时，返回该模板的设计	slug	是

get_design_guide 的指南主题：overview、footprint、tiles、 colors_and_layers、terrain、frame、hanging、paths、 texts_and_shapes、inserts、edge_labels、element_takeover、 details、focus_scaling、custom_houses、limits。

除了简介字段外，设计还可通过 edit_design 使用配置器中的所有字段：其中包括按打印尺寸（毫米）或地图尺寸（米）设定的文本和形状（主题 texts_and_shapes）、通用细节（屋顶、窗户、门和树木，带有立面样式和细节等级；地图宽度最多可达 3 km；主题 details）、可放大某个地点并向边缘逐渐缩小周围区域的焦点缩放（主题 focus_scaling），以及最多五栋位于空地或替换地图上建筑物的自定义房屋（主题 custom_houses）。 edit_tiles 的罗盘方向会选择其外法线与该方向夹角不超过 22.5° 的边，因此方向会随形状和旋转而变化：未旋转的六边形提供 ne、e、se、sw、w 和 nw。 validate_design 和 render_design 会列出每个瓦片的空闲边。

简述

create_design 的简述和 edit_design 的 changes；简述中只需提供地点，或 lat 和 lon；在 changes 中，未提供的字段会保留设计中的原值。

字段	含义	默认值
place	地点或地址，2 到 200 个字符；地点搜索的首个匹配结果会成为中心；若同时提供 lat 和 lon，则只用其名称	除非提供 lat 和 lon，否则必填
lat、lon	地图中心坐标，单位为度；纬度 −85.05 到 85.05，经度 −180 到 180；优先于 place
width	地图宽度，单位为米，100 到 30,000	1500
shape	hexagon、circle、square、rectangle（高度为宽度的 0.75 倍）、polygon	hexagon
sides	polygon 的边数，3 到 12；未指定 shape 时会选择 polygon	6
rotation	顺时针旋转角度，−360 到 360	0
tiles	瓦片数量，围绕第一个瓦片紧凑排列；Agent 最多使用 3 个；圆形使用一个瓦片	1
model_width	单个瓦片的打印宽度，单位为毫米，50 到 300	200
colors	颜色模板 single、two、four，或包含可选 template 的对象；颜色可按组（ground、green、water、traffic）、按图层类型（terrain、paved_areas、bare_ground、vegetation、agriculture、water_areas、sea、waterways、major_roads、local_roads、paths、railways、buildings）、按 frame 或 label 指定，格式为 RRGGBB 或 #RRGGBB；图层类型优先于所属组，每种不同的颜色使用一卷耗材	four
relief	true 表示真实地形起伏，false 表示平面	自动（高程差低于 300 m 时为平面）
exaggeration	垂直夸大倍数，0.1 到 10	1
frame	none、integrated、separate	none
label	第一个瓦片朝南的空闲边上的边缘文字；若该边不可用，则放在第一个空闲边上；最多 64 个字符；设计已有边缘文字时，新文字会替换其第一条边缘文字	无
lang	通知语言，de 或 en；未指定时，使用调用的 lang 参数	en

工作流

1. search_places 查找地点；create_design 将简述转换为完整设计。简述中的中心就是瓦片 0 的中心。
2. edit_design 修改简述字段并更新其他字段；edit_tiles 在 validate_design 列出的空闲边上添加或移除瓦片；find_map_elements 返回可直接插入的道路、建筑、区域和地面区域。
3. validate_design 检查已修改的设计，但不生成设计。
4. render_design 以图像和交互式 3D 视图展示设计。
5. share_design 返回供用户使用的链接。

示例提示词

• “创建一幅宽 3 km 的哈尔施塔特六边形地形起伏模型，垂直夸大 1.5 倍，并以 3D 展示给我。”
• “制作一幅维也纳市中心的方形城市地图，宽 2 km，使用两种颜色，添加边缘文字‘Wien’，并给我一个可在配置器中打开的链接。”
• “用三个六边形瓦片制作一幅萨尔茨堡墙面地图，添加一体式边框，并将 Getreidegasse 标成红色。”
• “为我展示圆形地形起伏模型中的 Großglockner，宽 8 km，并比较 1.2 倍和 2 倍的垂直夸大效果。”

examples 文件夹以 JSON 文件形式保存了前三个示例。每个文件都包含英文和德文提示词、create_design 的简述、按调用顺序排列的工具调用，以及该简述的起始链接。步骤会列出 brief 和 design 之外的参数：create_design 接收文件中的简述，之后每次调用都接收当前设计。

不使用 MCP 客户端时

助手会采用以下三种方式中可用的第一种：

1. NeuronForm 的 MCP 工具已连接：助手调用这些工具。

2. 助手可以通过代码工具、沙盒或终端运行可访问互联网的代码：它会通过 HTTP 直接调用 MCP 地址。每个请求都是一个 JSON-RPC POST，并由一个 JSON 响应返回；服务端不保留会话，因此无需 initialize，而 tools/list 会列出工具及其架构。create_design 会在 result.structuredContent.design 下返回设计：

   curl -s https://neuronform.com/mcp \
     -H 'content-type: application/json' \
     -H 'accept: application/json, text/event-stream' \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_design","arguments":{"brief":{"place":"Hallstatt","width":3000,"shape":"hexagon","relief":true,"exaggeration":1.5}}}}'
   

   助手会将该设计作为 DESIGN 传入后续调用：render_design 会以 base64 图像内容的形式返回模型的 JPEG 图像，并在 structuredContent.viewer 下返回 3D 查看器链接，有效期为 1 小时；share_design 会在 structuredContent.url 下返回链接，打开后会在配置器中呈现完全相同的设计，有效期为 90 天。

   {"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"render_design","arguments":{"design":DESIGN}}}
   {"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"share_design","arguments":{"design":DESIGN}}}
   

3. 助手只能读取网页：它会编写一个包含地点和设置（见下一节）的起始链接，并将其提供给用户。打开链接后，配置器会构建真实模型并显示其 3D 预览；助手会说明打开链接后即可看到模型，不会自行展示任何图片并称其为 NeuronForm 模型。

不使用 MCP 的聊天起始链接

不使用 MCP 的聊天可以通过配置器的起始链接传递设计：

https://neuronform.com/map/app?place=Hallstatt&width=3000&shape=hexagon&relief=true&exaggeration=1.5

也可以使用自定义颜色，这里采用沙色地面、青绿色区域、藏青色水域和珊瑚色道路：

https://neuronform.com/map/app?place=Ternitz&width=1800&shape=hexagon&colors=four&color_ground=f4e3c1&color_green=2a9d8f&color_water=1e3a8a&color_traffic=e76f51

查询参数对应设计概要中的字段：place、lat、lon、width、shape、sides、rotation、tiles、model_width、colors、relief、exaggeration、frame 和 label；colors 只能使用模板名称。参数 color_<key> 用于为设计概要中 colors 对象的某个键设置 RRGGBB 格式的颜色值（不带 #）；该键可以是分组 ground、green、water 或 traffic，图层类型（例如 buildings 或 sea）、frame，或 label；这些颜色会在模板颜色之后应用。提示信息使用配置器的语言。 只需提供 place，或同时提供 lat 和 lon。值需进行 URL 编码，例如用 %20 表示空格。数字采用十进制，relief 的值为 true 或 false。配置器会使用 create_design 的编译器构建设计，并指出每个经过调整的值；如果链接包含格式错误的值，或者地点搜索未能找到该地点，配置器会在不加载设计的情况下打开，并说明原因。

限制与公平使用

规则	值
政策	无账户访客的限制：最多 3 个瓦片、最多 20 条自定义线，以及简报中规定的范围；list_templates 中未更改的图库模板保留其自身的瓦片数量
通用细节	屋顶、窗户、门和树木适用于地图宽度不超过 3 km 的情况；超过此宽度时，只要设计启用了细节，服务就会在 details 字段拒绝该设计
自定义房屋	每个设计最多 5 栋；单栋房屋的细节预算为 200 万个三角形，服务可能另行设定该预算
渲染	所有 Agent 每小时最多生成 2,000 个新模型；模型仍在缓存中的渲染不计入此数，渲染后的设计最多缓存 24 小时
每个调用地址	每小时 600 次渲染调用和 1,200 次查找（搜索、简报、设计编辑、元素搜索、瓦片编辑、验证、模板列表、查看器下载）；每 24 小时 500 个新分享链接
优先级	网站访客享有优先权；他们占用服务期间，Agent 会收到“繁忙，请在 10 秒后重试”
容量	地点搜索、设计验证和图像生成在网站共享的有限容量内运行；超出容量的调用会失败，并返回错误：“服务当前无法接受更多此类请求；请稍后再试”
模型大小	超过约 100 万个三角形的模型会被拒绝用于 Agent；请缩小宽度或减少瓦片数量，或分享设计并在配置器中打开
地图数据	单个模型最多读取 2 GiB（2048 MiB）的解码地图数据；如果设计的地图区域包含更多数据，例如密集城市的宽阔地图，render_design 和 find_map_elements 会拒绝该设计，并返回“所选地图区域包含的数据量超出单个模型的处理能力”；重试相同设计仍会遇到同一限制，而缩小地图区域或关闭树木、窗户和门等细节可以减少地图数据
分享链接	匿名快照有效期为 90 天；对于未更改的设计，重复调用会返回此前签发的链接，前提是该链接至少还有一天有效期，且服务仍将其保存在缓存中
查看器	每次渲染都会生成一个有效期为一小时的查看器链接
限制区域、国家/地区	与网站访客适用的规定相同：军事限制区域无法打印，且部分国家/地区不提供此服务

使用免费。禁止批量检索和规避限制；请参阅下方条款。

维护

运营方将配置器（面向访客或账户）或整个应用设为维护状态时，MCP 地址会对每个请求返回 HTTP 503，而不是 JSON-RPC 响应，因此不会运行任何工具，MCP 客户端也会报告请求失败；3D 查看器的下载也会以相同方式响应。响应包含：

• Retry-After 标头，其中包含预计维护结束前的秒数，最少为 60，最多为 86,400；如果没有预计结束时间，则为 300；
• 类型为 tag:neuronform.com,2026:maintenance 的问题 JSON 正文，其中包含代码 maintenance.configurator 或 maintenance.site，以及对象 maintenance，该对象包含 scope、运营方的消息 message_de 和 message_en，以及预计结束时间 expected_end（RFC 3339，UTC）；运营方未设置的字段均为 null。

当前生效的开关可在 neuronform.com/map/api/v1/maintenance 查看。 请在 Retry-After 指定的时间后重试。

隐私与条款

请求包含工具参数（例如地点和设计），以及调用系统的 IP 地址：对于 Claude 或 ChatGPT，是聊天平台的 IP 地址；对于 Claude Code、Cursor 或 VS Code，是用户自己的 电脑的 IP 地址。客户端连接时会报告其客户端软件名称和版本，NeuronForm 会将其用于 使用情况统计。NeuronForm 不会收到任何账户数据，也不会收到聊天中的其他内容。地点 搜索由 NeuronForm 服务的地点目录作答，该目录由 OpenStreetMap 数据构建；搜索词不会 传送到其他服务。 助手提供商负责处理其平台上的聊天内容。

• 隐私政策：English、Deutsch
• 条款中的 AI Agent 章节：English、Deutsch

地图数据与署名

该服务从一个数据源注册表中获取数据源名称。每个 render_design 的结果都会在 attribution 字段中，按调用所用语言提供其模型数据源的署名信息；其图像则包含地图 数据和地形数据的署名信息；模型包含海底深度时，也会准确标明。展示或发布设计图像时， 请保留署名信息。

注册表列出了每个数据源及其角色、署名信息、许可证、许可证要求的声明和引用：

• JSON 格式：neuronform.com/map/api/v1/data-sources
• 网页：neuronform.com/licenses/en

MCP 注册表

server.json 描述了官方 MCP 注册表中的服务，其名称为 com.neuronform/mcp。 注册表会验证该命名空间是否与域名 neuronform.com 对应。它遵循架构 https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json。 注册表在 registry.modelcontextprotocol.io/v0/servers?search=com.neuronform 列出了该服务，版本为 0.1.0。该服务通过 mcp-publisher login http --domain neuronform.com 发布，其 Ed25519 公钥由 neuronform.com 托管于 /.well-known/mcp-registry-auth。

联系方式

问题与反馈：[email protected]。

许可证

本仓库的文档和示例采用 MIT 许可证。该许可证不涵盖 NeuronForm 服务或其 结果，例如图像、3D 视图和分享链接；这些内容受 NeuronForm 的 条款约束。

德语

NeuronForm 将 OpenStreetMap 数据制作成适合打印的多色 3D 地图模型。通过公共 MCP 服务， Claude 或 ChatGPT 等 AI 助手可以在聊天中设计这些模型：

• 查找地点；
• 创建并修改设计稿；
• 将其显示为图像；如果聊天支持，还可显示为可旋转的 3D 视图；
• 提供一个链接，打开配置器中的对应设计稿。

Agent 不能导出或购买；这些操作只能在配置器中通过个人账户完成。

• MCP 地址： https://neuronform.com/mcp（Streamable HTTP，请求上限为 2 MiB，无需账户，无需 API 密钥，免费）。
• 设置： 在 Claude 中依次选择“Customize” › “Connectors” › “+ Add” › “Add custom connector”，并将身份验证设为“No sign in”。在 Claude Code 中使用 claude mcp add --transport http neuronform https://neuronform.com/mcp。ChatGPT、Cursor 和 VS Code 的设置方法请参阅上文各节或AI 集成页面。
• 工具： search_places、create_design、edit_design、get_design_guide、find_map_elements、edit_tiles、validate_design、render_design、share_design、list_templates。每个工具都接受可选参数 lang（de 或 en，默认为 en），用于指定摘要、提示和错误消息的语言。
• 没有 MCP 客户端： 配备代码工具、沙盒或终端的助手可直接通过 HTTP 调用 MCP 地址：每个请求都是一个 JSON-RPC POST，并返回 JSON 响应，无需会话，也无需 initialize（示例 curl 命令见“Without an MCP client”一节）。Accept 标头可以指定 application/json、application/json, text/event-stream 或 */*，也可以省略；如果仅指定 text/event-stream，服务端会返回 HTTP 406。
• 无需 MCP 的启动链接： https://neuronform.com/map/app?place=Hallstatt&width=3000&shape=hexagon&relief=true&exaggeration=1.5；自定义颜色时，针对某个组（ground、green、water、traffic）、某个图层（如 buildings 或 sea）、frame 或 label 设置 color_<键> 参数，值为不带 # 的 RRGGBB，例如 https://neuronform.com/map/app?place=Ternitz&width=1800&shape=hexagon&colors=four&color_ground=f4e3c1&color_green=2a9d8f&color_water=1e3a8a&color_traffic=e76f51
• 限制：
  • 适用无账户访客的限制（最多 3 个瓦片和 20 条自定义线条）。
  • 地图宽度不超过 3 km 时可生成通用细节（屋顶、窗户、门和树木）；如果开启细节，服务端会拒绝宽度更大的设计。每个设计最多可添加五栋自定义房屋，每栋房屋的细节预算为 200 万个三角形。
  • 所有 Agent 每小时最多可重新计算 2,000 个模型；查看尚在缓存中的模型不计入此限额。
  • 网站访客优先。
  • 地点搜索、设计验证和图片生成共用有限容量，网站也会使用该容量；容量耗尽时，服务端会暂时拒绝此类后续调用。
  • 对于超过约 100 万个三角形的模型，服务端会拒绝 Agent 的请求。
  • 单个模型最多读取 2 GiB（2048 MiB）的解码后地图数据；如果地图区域包含更多数据，服务端会拒绝该区域，直至选择更小的区域或减少细节。
• 维护： 只要运营方将配置器或整个应用设为维护状态，MCP 地址就会对每个请求返回 HTTP 503，而不是 JSON-RPC 响应。响应会在 Retry-After 中给出预计结束前的秒数（若未设置结束时间，则为 300），并在 maintenance 对象中提供维护消息和预计结束时间；维护状态可在 neuronform.com/map/api/v1/maintenance 查看。
• 隐私与条款： 隐私政策、一般条款与条件，“AI Agent 使用”一节。
• 地图数据和来源： render_design 的每个结果都会在 attribution 字段中列出其模型的数据来源署名；图片则会列出地图和地形数据的署名。该服务的来源目录列出了所有来源及其许可证、说明和引用：JSON 格式，以及许可证与署名页面。