Docs

202605 V9.3-MCP

发布于：2026-05-18

本文档说明如何在 Windows 电脑 Style3D 中开启 MCP 服务，并通过 Claude Code 或 Codex 连接 Style3D MCP。
Claude Code 和 Codex 或者其他支持调用 MCP 服务的 Agent 任选一种配置即可。
如果几种工具需要同时使用，也可以分别添加同一个 Style3D MCP 服务。

一、使用前准备

开始前，请确认：
  • Style3D MCP 服务地址和端口号可在软件内查看或修改。（需要开通python订阅 和 mcp 功能权限）
本文档默认使用以下 MCP 服务地址：
http://127.0.0.1:57281/mcp
如果你在 Style3D 中修改了端口号，后续 Claude Code 或 Codex 命令中的端口号也需要同步修改。

二、在 Style3D 中开启 MCP 服务

使用软件内置的设置开启

打开 Style3D 软件，进入以下位置：偏好设置 -> 其他 -> MCP 服务
在 MCP 服务设置中，确认 MCP 服务已开启，并检查服务地址和端口号。
默认地址通常为：
http://127.0.0.1:57281
如果需要修改端口号，可以在此处修改。修改后，请记住新的端口号，后续添加 MCP 时需要使用同一个地址。

使用命令行开启

如果需要同时打开多个 Style3D 客户端，并让不同的 MCP 客户端分别连接到不同的 Style3D 实例，可以通过 Style3D 提供的命令行参数指定 MCP 服务端口。
打开 Windows PowerShell，执行以下命令：
"C:\Program Files\Style3D\Style3D.exe" --mcp http://127.0.0.1:5555
其中 5555 是当前 Style3D 实例使用的 MCP 服务端口。启动多个 Style3D 实例时，只需要为每个实例设置不同的端口号，然后在Claude Code 或 Codex 中使用对应的 MCP 地址，即可实现不同客户端分别连接不同 Style3D 软件实例。

三、选择一种客户端连接 Style3D MCP

方案 A：使用 Claude Code

1. 安装 Claude Code

打开 Windows PowerShell，执行以下命令：
irm https://claude.ai/install.ps1 | iex
安装完成后，需要将 claude.exe 添加到环境变量， 在Windows PowerShell 中执行命令：
$env:PATH += ";$env:USERPROFILE\.local\bin"
关闭并重新打开 PowerShell，然后执行：
claude --version
如果能够正常显示版本号，说明 Claude Code 已安装成功。

2. 添加 Style3D MCP 到 Claude Code

确认 Style3D 已启动，并且 MCP 服务已开启后，在 Windows PowerShell 中执行：
claude mcp add --transport http style3d http://127.0.0.1:57281/mcp --scope user
命令说明：
  • --transport http：使用 HTTP 方式连接 MCP 服务。
  • style3d：在 Claude Code 中显示的 MCP 服务名称。
  • http://127.0.0.1:57281/mcp：Style3D MCP 服务地址。
  • --scope user：将 MCP 配置添加到当前用户范围。

方案 B：使用 Codex

1. 安装 Node.js

使用 Codex 前，需要先安装 Node.js。安装完成后，关闭并重新打开命令行工具，然后执行：
node --version
再执行：
npm --version
如果两个命令都能正常显示版本号，说明 Node.js 和 npm 已可用。

2. 安装 Codex

在命令行中执行以下命令安装 Codex：
npm install -g @openai/codex
安装完成后，执行：
codex --version
如果能够正常显示版本号，说明 Codex 已安装成功。

3. 添加 Style3D MCP 到 Codex

确认 Style3D 已启动，并且 MCP 服务已开启后，在命令行中执行：
codex mcp add style3d --url http://127.0.0.1:57281/mcp

四、验证 MCP 是否添加成功

Claude Code 验证

执行以下命令查看已配置的 MCP 服务：
claude mcp list
如果列表中出现 style3d，说明 Style3D MCP 已成功添加到 Claude Code。

Codex 验证

执行以下命令查看已配置的 MCP 服务：
codex mcp list
如果列表中出现 style3d，说明 Style3D MCP 已成功添加到 Codex。

五、端口变更说明

如果 Style3D MCP 服务端口不是 57281，需要在添加命令中替换端口号。
例如，Style3D MCP 服务端口改为 60000 时，Claude Code 命令应改为：
claude mcp add --transport http style3d http://127.0.0.1:60000/mcp --scope user
Codex 命令应改为：
codex mcp add style3d --url http://127.0.0.1:60000/mcp
端口号必须与 Style3D 中 偏好设置 -> 其他 -> MCP 服务 显示的端口号一致。
End
提交反馈
上一页
内容为空
下一页
202604 V9.3版本更新