Speckle MCP Server

Un servidor Model Context Protocol (MCP) per a interactuar amb Speckle, el centre de dades col·laboratiu que es connecta amb les vostres eines AEC.

Visió general

Aquest servidor MCP actua com a pont entre l'API de Speckle i les aplicacions client i expone un conjunt d'eines que permeten als usuaris:

• Llistar i cercar projectes Speckle
• Recuperar informació detallada del projecte
• Accedir a les versions de model dins dels projectes
• Recuperar i consultar objectes i les seves propietats de versions específiques

Instal·lació

Requisits previs

• Python 3.13 o superior
• Compte Speckle amb un token d'accés personal
• uv per a la gestió de dependències i entorns virtuals

Configuració

1. Clonar aquest repositori:

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

2. Assegureu-vos que tingueu Python 3.13 instal·lat:

   python --version  # Should show Python 3.13.x
   

3. Instal·lar dependències amb uv:

   uv pip install -r requirements.txt
   

Configuració

Variables d'entorn

El servidor requereix les següents variables d'entorn:

• SPECKLE_TOKEN: El vostre token d'accés personal Speckle (obligatori)
• SPECKLE_SERVER: L'URL del servidor Speckle (per defecte https://app.speckle.systems)

Configuració MCP

Per utilitzar aquest servidor amb Claude, cal actualitzar el fitxer de configuració MCP. El fitxer de configuració es troba habitualment a:

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

Afegiu o actualitzeu l'entrada “speckle” a la secció 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"
      }
    }
  }
}

Reemplaceu /path/to/speckle-mcp amb la ruta real al directori que conté el paquet speckle_mcp.

Eines disponibles

Projectes

• list_projects: Llista tots els projectes Speckle accessibles

  • Paràmetres:
    • limit (opcional): Nombre màxim de projectes a recuperar (per defecte: 20)

• get_project_details: Recupera informació detallada d'un projecte específic

  • Paràmetres:
    • project_id: L'ID del projecte Speckle a recuperar
    • limit (opcional): Nombre màxim de models a recuperar (per defecte: 20)

• search_projects: Cerca projectes per nom o descripció

  • Paràmetres:
    • query: Termini de cerca a buscar en noms i descripcions de projectes

Models

• get_model_versions: Llista totes les versions d'un model específic

  • Paràmetres:
    • project_id: L'ID del projecte Speckle
    • model_id: L'ID del model per al qual recuperar versions
    • limit (opcional): Nombre màxim de versions a recuperar (per defecte: 20)