FindMCP Logo FindMCP.info
Speckle MCP Server

Speckle MCP Server

site icon
2025.03.11 9
Python协作数据枢纽AEC 工具交互交流协作
Speckle MCP Server 是一个模型上下文协议（MCP）服务器，用于与 Speckle 交互。Speckle 是一个协作数据枢纽，连接各种 AEC（建筑、工程和施工）工具。该服务器充当 Speckle API 和客户端应用程序之间的桥梁，提供了一系列工具来管理和查询 Speckle 项目、模型版本和对象。
View on GitHub

Overview

基本能力

产品定位

Speckle MCP Server 是一个用于与 Speckle 协作数据枢纽交互的 MCP 服务器，主要用于建筑、工程和施工（AEC）领域的数据管理和协作。

核心功能

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

适用场景

  • AEC 工具的数据管理和协作
  • 项目信息的集中管理和查询
  • 模型版本和对象属性的检索和分析

工具列表

  1. Projects
  2. list_projects: 列出所有可访问的 Speckle 项目
  3. get_project_details: 检索特定项目的详细信息

  4. search_projects: 按名称或描述搜索项目

  5. Models

  6. get_model_versions: 列出特定模型的所有版本

  7. Objects

  8. get_version_objects: 从特定版本中检索对象
  9. query_object_properties: 查询版本中对象的特定属性

常见问题解答

  • 认证问题：确保 Speckle token 有效且具有必要的权限
  • 服务器日志：检查服务器日志以获取详细的错误消息
  • 环境变量：确保 MCP 配置中正确设置了环境变量

使用教程

使用依赖

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

安装教程

  1. 克隆仓库： bash git clone https://github.com/bimgeek/speckle-mcp.git cd speckle-mcp

  2. 确保安装了 Python 3.13： bash python --version # 应显示 Python 3.13.x

  3. 使用 uv 安装依赖： bash uv pip install -r requirements.txt

调试方式

  1. 确保环境变量 SPECKLE_TOKEN 和 SPECKLE_SERVER 已正确设置
  2. 检查 MCP 配置文件是否正确配置
  3. 运行服务器并检查日志以排查问题

许可证

该项目遵循 MIT 开源许可条款。