冬虫夏草
Grasshopper的MCP服务器。 让AI代理或脚本直接控制您的参数化设计画布和Rhino渲染工具。
模型上下文协议(MCP) 提供了一个标准化的界面来控制应用程序,无论是来自人工智能助手还是您自己的代码。
特性
- 全蚱蜢控制 --添加元件、接线、设置值、管理组
- Rhino集成 --烘焙几何体、管理图层、应用PBR材质、渲染场景
- 自然语言 --描述你想要什么,让人工智能来构建它
- 直接脚本编写 --从Python或任何MCP客户端调用工具,无需人工智能
需求
- 犀牛8.21+ (需要.NET 8)
- 用于AI:克劳德桌面、克劳德代码、光标、VS代码或任何兼容MCP的助手
安装
- 复制到Grasshopper组件文件夹:
*File → 特殊文件夹→ 组件文件夹*
- windows用户:右键单击文件→ 属性→ 勾选“解锁”→ OK
用法
- 放下 冬虫夏草 画布上的组件(*参数→ Util → 冬虫夏草*)
默认情况下,服务器在端口26929上启动。可选输入:
- 端口:更改HTTP端口 - 调试级别:设置为1+以查看Rhino中的请求/响应流量
- 配置您的MCP客户端:
Claude Desktop
Claude Desktop使用stdio传输,因此它需要 mcp-remote 桥。需要 .
添加到您的配置文件中:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"cordyceps": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://127.0.0.1:26929/mcp"]
}
}
}保存后重新启动Claude Desktop。
Claude Code
claude mcp add --transport http cordyceps http://127.0.0.1:26929/mcpCursor, VS Code, and other HTTP clients
{
"mcpServers": {
"cordyceps": {
"type": "streamable-http",
"url": "http://127.0.0.1:26929/mcp"
}
}
}- 开始构建——用自然语言描述你想要什么
示例
Make an animated GIF that shows the full journey from parametric modeling
to photorealistic render. The subject is a small collection of geometric
forms — maybe five or six objects with varied shapes, scales, and
proportions. Arrange them as a pleasing composition.AI自主构建一切——在Grasshopper中创建参数化几何体,烘焙到Rhino,应用PBR材质,配置渲染环境和照明,并捕获平滑的轨道动画。
脚本编写
直接从Python或任何MCP客户端库调用工具:
from mcp import ClientSession
async with ClientSession(transport) as session:
# Add a slider and circle
slider = await session.call_tool('gh_canvas', {
'action': 'add', 'type': 'Number Slider', 'x': 50, 'y': 50
})
circle = await session.call_tool('gh_canvas', {
'action': 'add', 'type': 'Curve/Circle', 'x': 200, 'y': 50
})
# Connect slider output to circle radius
await session.call_tool('gh_wire', {
'action': 'connect',
'sourceId': slider['id'], 'sourceParam': '0',
'targetId': circle['id'], 'targetParam': 'R'
})请参阅 MCP Python SDK 有关传输设置和客户端详细信息。
工具
冬虫夏草提供 7个工具,110+个动作 --整合以最大限度地减少上下文窗口的使用。相关操作被分组到一个工具下,该工具具有 action 参数。
蚱蜢
| 工具 | 说明 |
|---|---|
gh_canvas | 组件、值、组、烘焙、可变参数 |
gh_wire | 连接管理 |
gh_document | 保存、清除、撤消/重做、快照、画布捕获 |
gh_script | 脚本组件配置 |
gh_inspect | 状态、输出、数据跟踪、调试 |
犀牛
| 工具 | 说明 |
|---|---|
rhino_scene | 对象、图层、选择、可见性 |
rhino_render | 视口、摄影机、材质、照明、环境、渲染 |
文档
冬虫夏草将指南和模式作为资源暴露给MCP客户端。当您的AI助手需要数据树、类型系统、组件模式或渲染工作流的指导时,它可以自动读取这些内容。
直接浏览文档: src/Cordyceps/Knowledge/
故障排除
| 问题 | 解决方案 |
|---|---|
| 插件无法加载 | 验证Rhino 8.21+。解锁.gha文件(Windows)或清除隔离(macOS)。 |
| 无法连接 | 请确保冬虫夏草组件位于画布上。检查端口 |
| Claude Desktop无法连接 | 请确保已安装Node.js。检查Rhino是否正在服用冬虫夏草。更改配置后重新启动Claude Desktop。 |
| 找不到组件 | 使用 gh_canvas(action='search', query='...') 找到确切的名字。 |
| 无命令输出 | 将DebugLevel输入设置为1,以查看Rhino命令历史中的流量。 |
建筑
dotnet build src/Cordyceps/Cordyceps.csproj______________________________________________________________________
