斑点 MCP 服务器

用于与 Speckle（与您的 AEC 工具连接的协作数据中心）交互的模型上下文协议 (MCP) 服务器。

概述

该 MCP 服务器充当 Speckle 的 API 和客户端应用程序之间的桥梁，并公开了一组允许用户执行以下操作的工具：

列出并搜索 Speckle 项目
检索详细项目信息
访问项目内的模型版本
从特定版本检索和查询对象及其属性

Related MCP server: MCP Etherscan Server

安装

先决条件

Python 3.13 或更高版本
带有个人访问令牌的 Speckle 帐户
uv 用于依赖管理和虚拟环境

设置

克隆此存储库：
git clone https://github.com/bimgeek/speckle-mcp.git cd speckle-mcp
确保已安装 Python 3.13：
python --version # Should show Python 3.13.x
使用 uv 安装依赖项：
uv pip install -r requirements.txt

配置

环境变量

服务器需要以下环境变量：

SPECKLE_TOKEN ：您的 Speckle 个人访问令牌（必需）
SPECKLE_SERVER ：Speckle 服务器 URL（默认为https://app.speckle.systems ）

MCP 配置

要将此服务器与 Claude 一起使用，您需要更新 MCP 配置文件。配置文件通常位于：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
Windows： %APPDATA%\Claude\claude_desktop_config.json

在mcpServers部分中添加或更新“speckle”条目：

{ "mcpServers": { "speckle": { "command": "uv", "args": [ "--directory", "/path/to/speckle-mcp", "run", "speckle_server.py" ], "env": { "SPECKLE_TOKEN": "YOUR_SPECKLE_API_TOKEN_HERE", "SPECKLE_SERVER": "https://app.speckle.systems" } } } }

将/path/to/speckle-mcp替换为包含speckle_mcp包的目录的实际路径。

可用工具

项目

list_projects ：列出所有可访问的 Speckle 项目
- 参数：
  - limit （可选）：要检索的最大项目数（默认值：20）
get_project_details ：检索有关特定项目的详细信息
- 参数：
  - project_id ：要检索的 Speckle 项目的 ID
  - limit （可选）：要检索的最大模型数量（默认值：20）
search_projects ：按名称或描述搜索项目
- 参数：
  - query ：在项目名称和描述中查找的搜索词

模型

get_model_versions ：列出特定模型的所有版本
- 参数：
  - project_id ：Speckle 项目的 ID
  - model_id ：要检索版本的模型的 ID
  - limit （可选）：要检索的最大版本数（默认值：20）

对象

get_version_objects ：从特定版本检索对象
- 参数：
  - project_id ：Speckle 项目的 ID
  - version_id ：从中检索对象的版本的 ID
  - include_children （可选）：是否在响应中包含子对象（默认值：false）
query_object_properties ：查询版本中对象的特定属性
- 参数：
  - project_id ：Speckle 项目的 ID
  - version_id ：从中检索对象的版本的 ID
  - property_path ：属性的点符号路径（例如“elements.0.name”）