Rhino MCP 服务器

⚠️ 正在建设中 ⚠️
该项目目前处于积极开发阶段，尚未正常运行。Rhino 插件在创建对象时存在问题。
我们正在积极寻求社区的帮助，尤其是熟悉 Rhino API、C# 插件或 MCP 集成的开发者。

概述

此项目旨在通过 MCP 协议实现 Rhino 3D 的 AI 辅助建模功能，允许用户通过 AI 助手（如 Claude）创建和操作 3D 对象。目前仍处于开发阶段，存在一些问题，特别是插件在对象创建时的稳定性。

系统架构

项目结构如下：

1. Python 脚本：

   • combined_mcp_server.py：主 MCP 服务器实现。
   • diagnose_rhino_connection.py：用于测试 Rhino 连接状态的诊断工具。
   • log_manager.py：管理日志文件并提供分析功能。

2. Shell 脚本：

   • server_launcher.sh：统一启动脚本，支持多种服务器模式。

3. 目录结构：

   • logs/：存储所有组件的日志文件。

功能模块

1. MCP 服务器实现

• combined_mcp_server.py：核心服务器实现，支持以下工具：
  • geometry_tools.create_sphere：创建指定中心和半径的球体。
  • geometry_tools.create_box：创建指定尺寸的长方体。
  • geometry_tools.create_cylinder：创建指定参数的圆柱体。
  • scene_tools.get_scene_info：获取当前场景信息。
  • scene_tools.clear_scene：清除场景中的所有对象。
  • scene_tools.create_layer：在文档中创建新图层。

2. 插件开发

• Rhino 插件：负责与 Rhino 的交互，目前存在以下问题：
  • 对象创建失败，需进一步调试和修复。

日志系统

项目采用统一的日志框架，记录以下内容：

• 服务器日志。
• 插件日志。
• AI 工作站日志。
• 诊断日志。

所有日志按组件分类存储于 logs/ 目录，并遵循一致的格式。通过 log_manager.py 可实现日志查看、分析和报告生成。

开发指南

项目结构

.
├── combined_mcp_server.py       # 主 MCP 服务器实现。
├── diagnose_rhino_connection.py # 测试 Rhino 连接状态的诊断工具。
├── log_manager.py               # 日志管理工具。
└── server_launcher.sh           # 统一启动脚本。

添加新功能

1. 新增工具：

   • 将新功能方法添加至 combined_mcp_server.py。
   • 确保遵循现有日志记录规范。

2. 诊断与修复：

   • 使用 diagnose_rhino_connection.py 测试插件与 Rhino 的连接状态。
   • 修复当前存在的对象创建问题，确保插件稳定运行。

3. 日志管理：

   • 更新日志框架以支持新功能模块。
   • 确保所有日志输出遵循统一格式。

故障排除

常见问题

1. 连接失败：

   • 检查是否有旧进程占用端口或资源。
   • 使用 server_launcher.sh help 重启相关服务。

2. 日志分析：

   • 查看 logs/ 目录中的详细日志以定位问题。
   • 使用 log_manager.py report 生成错误报告。

3. 插件调试：

   • 在 Rhino 中启用开发者模式，检查插件加载状态。
   • 确保所有 API 调用正确无误。

许可证

本项目遵循 MIT License 协议，具体内容见 LICENSE 文件。