Speckle MCP
连接Speckle API与客户端的MCP数据交互工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Speckle MCP。 它的用途是：连接Speckle API与客户端的MCP数据交互工具 详细介绍见：https://321skill.com/skills/speckle-mcp/ 请根据该页面的说明完成安装。
使用示例
“帮我把本地这个BIM模型文件上传到Speckle服务器上‘办公楼项目’的‘结构专业’流里。”，它会通过Speckle MCP工具读取您的文件，并使用您配置的令牌和服务器地址，将模型作为一次新的提交推送到指定的流中。或者，您可以说：“获取‘体育馆项目’主分支上最近三个提交的变更摘要。”，AI会调用该工具查询服务器并返回结构化的提交历史信息。
介绍
Speckle MCP是一个专为AI Agent设计的集成工具，旨在解决Speckle平台（一个开放的数据平台，用于建筑、工程和建造领域的3D数据）与AI客户端之间数据交互的难题。它通过MCP（Model Context Protocol）协议，将Speckle的API功能封装成标准化的工具，使得AI能够直接查询、发送和处理来自Speckle服务器的项目数据与3D模型。
使用Speckle MCP时，您需要在AI客户端（如Claude Desktop）中配置此Skill，并提供您的Speckle服务器地址和个人访问令牌。配置完成后，AI即可通过自然语言指令，如“获取项目X的最新提交数据”或“将模型Y发送到流Z”，来驱动该工具完成与Speckle服务器的数据交换。
这个Skill非常适合需要将AI能力与BIM（建筑信息模型）或AEC（建筑、工程、施工）数据工作流结合的专业人士。无论是开发自动化数据处理脚本的开发者，还是希望通过AI辅助分析设计模型的设计师或项目经理，都能从中受益。
在使用时，请确保您已拥有一个可访问的Speckle服务器（自托管或使用Speckle云服务）并已生成具有相应权限的访问令牌。由于涉及专业领域数据，建议用户对Speckle平台的基本概念（如流、提交、分支）有一定了解，以获得最佳体验。同时，注意令牌的保管，避免泄露。
核心特点
与通用API调用工具不同，它深度集成了Speckle的数据模型和操作逻辑，提供了开箱即用的、针对3D设计和BIM数据流的专用MCP工具集，无需用户从零开始构建与Speckle API的复杂交互。
注意事项
该Skill专为Speckle平台设计，不适用于连接其他非Speckle的3D数据源或通用API。
常见问题
Speckle MCP是什么？
它是一个让AI能通过MCP协议直接与Speckle服务器交互，读写3D项目数据的工具。
使用前需要准备什么？
需要一个Speckle服务器地址（或Speckle云账号）和一个具有适当权限的个人访问令牌。