tacit-mcp

MCP-Server, der KI-Assistenten mit digitalen Zwillingen von Tacit verbindet. Stellen Sie Fragen zu Ihren Gebäuden, Anlagen, Sensoren und Zonen in natürlicher Sprache.

Funktioniert mit Claude Desktop, Claude Code, Cursor, Windsurf und jedem MCP-kompatiblen Client.

Funktionsweise

Vier schreibgeschützte Werkzeuge:

Das GraphQL-Tool enthält die vollständige Schema-Referenz, sodass das KI-Modell Abfragen erstellen kann, ohne dass eine separate Dokumentation erforderlich ist.

Schnellstart

Option A: npx (empfohlen — keine Installation erforderlich)

npx -y @tacit/mcp-server

Verweisen Sie einfach Ihren MCP-Client darauf (siehe Konfiguration unten). Kein Klonen, kein Build-Prozess.

Option B: Klonen und Build

git clone https://github.com/ucl-sbde/tacit-mcp.git
cd tacit-mcp
npm install
npm run build

Sie benötigen einen Tacit-API-Schlüssel. Diesen erhalten Sie in Ihrem Dashboard unter app.betacit.com unter Site Settings > API Keys.

Verbindungsmethoden

1. Stdio-Transport (lokal, Standard)

Die Standardmethode — der MCP-Client startet den Server als untergeordneten Prozess. Am besten für die individuelle Nutzung auf Ihrem eigenen Rechner geeignet.

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Fügen Sie dies zu .mcp.json in Ihrem Projekt hinzu:

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Fügen Sie dies zu .cursor/mcp.json hinzu:

{
  "mcpServers": {
    "tacit": {
      "command": "npx",
      "args": ["-y", "@tacit/mcp-server"],
      "env": {
        "TACIT_API_KEY": "your-api-key"
      }
    }
  }
}

2. Streambarer HTTP-Transport (remote)

Führen Sie den Server als persistenten HTTP-Dienst aus. Am besten für Teams, Cloud-Bereitstellungen und Umgebungen geeignet, in denen Benutzer Node.js nicht lokal installieren können.

# Start the HTTP server
TACIT_API_KEY=your-api-key npm run start:http

# Or with npx
TACIT_API_KEY=your-api-key npx --package @tacit/mcp-server tacit-mcp-http

Der Server lauscht standardmäßig auf http://0.0.0.0:3001/mcp.

Verbindung von einem beliebigen MCP-Client

Verweisen Sie Ihren Client mit einem Bearer-Token auf die Server-URL:

{
  "mcpServers": {
    "tacit": {
      "type": "streamable-http",
      "url": "https://your-host:3001/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

HTTP-Konfiguration

Gesundheitsprüfung (Health Check)

GET /health → { "status": "ok", "transport": "streamable-http", "sessions": 3 }

3. OAuth 2.1 (Enterprise)

Für Produktionsbereitstellungen, bei denen sich Benutzer über den Anmeldeablauf von Tacit authentifizieren sollen, anstatt API-Schlüssel zu verwalten:

TACIT_OAUTH_ISSUER=https://app.betacit.com npm run start:http

Dies ermöglicht:

• Dynamische Client-Registrierung — MCP-Clients registrieren sich automatisch

• Autorisierungscode + PKCE — Benutzer melden sich über die Web-Benutzeroberfläche von Tacit an

• Token-Aktualisierung — Sitzungen bleiben ohne erneute Authentifizierung aktiv

• Token-Widerruf — saubere Beendigung der Sitzung

MCP-Clients, die OAuth unterstützen (wie Claude Desktop), erkennen die Authentifizierungskonfiguration automatisch über den Metadaten-Endpunkt .well-known/oauth-authorization-server.

4. Docker

docker run -p 3001:3001 -e TACIT_API_KEY=your-api-key tacit/mcp-server

Verbinden Sie sich unter Verwendung der oben genannten HTTP-Transportkonfiguration.

Ausprobieren

Sobald die Verbindung hergestellt ist, können Sie Ihren KI-Assistenten Dinge fragen wie:

• "List all my building sites"

• "What AHUs are in Tower West?"

• "Show me temperature sensors on AHU-001"

• "Get the last 24 hours of supply air temperature data"

• "What equipment feeds the lobby zone?"

Umgebungsvariablen

Entwicklung

npm run dev       # watch mode — stdio transport
npm run dev:http  # watch mode — HTTP transport
npm run build     # compile TypeScript
npm start         # run stdio transport
npm run start:http # run HTTP transport

Lizenz

MIT