Servidor MCP Speckle

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con Speckle, el centro de datos colaborativos que se conecta con sus herramientas AEC.

Descripción general

Este servidor MCP actúa como un puente entre la API de Speckle y las aplicaciones cliente y expone un conjunto de herramientas que permiten a los usuarios:

Listado y búsqueda de proyectos de Speckle
Recuperar información detallada del proyecto
Acceder a versiones de modelos dentro de los proyectos
Recuperar y consultar objetos y sus propiedades de versiones específicas

Related MCP server: MCP Etherscan Server

Instalación

Prerrequisitos

Python 3.13 o superior
Cuenta Speckle con un token de acceso personal
uv para gestión de dependencias y entornos virtuales

Configuración

Clonar este repositorio:
git clone https://github.com/bimgeek/speckle-mcp.git cd speckle-mcp
Asegúrese de tener instalado Python 3.13:
python --version # Should show Python 3.13.x
Instalar dependencias usando uv:
uv pip install -r requirements.txt

Configuración

Variables de entorno

El servidor requiere las siguientes variables de entorno:

SPECKLE_TOKEN : Su token de acceso personal de Speckle (obligatorio)
SPECKLE_SERVER : La URL del servidor Speckle (el valor predeterminado es https://app.speckle.systems )

Configuración de MCP

Para usar este servidor con Claude, debe actualizar su archivo de configuración de MCP. Este archivo suele estar en:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Agregue o actualice la entrada "speckle" en la sección mcpServers :

{ "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" } } } }

Reemplace /path/to/speckle-mcp con la ruta real al directorio que contiene el paquete speckle_mcp .

Herramientas disponibles

Proyectos

list_projects : enumera todos los proyectos Speckle accesibles
- Parámetros:
  - limit (opcional): Número máximo de proyectos a recuperar (predeterminado: 20)
get_project_details : recupera información detallada sobre un proyecto específico
- Parámetros:
  - project_id : El ID del proyecto Speckle que se recuperará
  - limit (opcional): número máximo de modelos a recuperar (predeterminado: 20)
search_projects : Busca proyectos por nombre o descripción
- Parámetros:
  - query : El término de búsqueda que se debe buscar en los nombres y descripciones del proyecto

Modelos

get_model_versions : enumera todas las versiones de un modelo específico
- Parámetros:
  - project_id : El ID del proyecto Speckle
  - model_id : El ID del modelo para el que se recuperarán las versiones
  - limit (opcional): número máximo de versiones a recuperar (predeterminado: 20)

Objetos

get_version_objects : recupera objetos de una versión específica
- Parámetros:
  - project_id : El ID del proyecto Speckle
  - version_id : El ID de la versión de la que se recuperarán los objetos
  - include_children (opcional): si se deben incluir objetos secundarios en la respuesta (valor predeterminado: falso)
query_object_properties : consulta propiedades específicas de objetos en una versión
- Parámetros:
  - project_id : El ID del proyecto Speckle
  - version_id : El ID de la versión de la que se recuperarán los objetos
  - property_path : La ruta de notación de puntos a la propiedad (por ejemplo, "elements.0.name")

Solución de problemas

Si encuentra problemas de autenticación, asegúrese de que su token Speckle sea válido y tenga los permisos necesarios.
Consulte los registros del servidor para ver mensajes de error detallados
Asegúrese de que las variables de entorno estén configuradas correctamente en la configuración de MCP