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

1. Clonar este repositorio:

   git clone https://github.com/bimgeek/speckle-mcp.git
   cd speckle-mcp

2. Asegúrese de tener instalado Python 3.13:

   python --version  # Should show Python 3.13.x

3. 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

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.