tacit-mcp

MCP-сервер, который подключает ИИ-ассистентов к цифровым двойникам зданий Tacit. Задавайте вопросы о ваших зданиях, оборудовании, датчиках и зонах на естественном языке.

Работает с Claude Desktop, Claude Code, Cursor, Windsurf и любым MCP-совместимым клиентом.

Что он делает

Четыре инструмента только для чтения:

Инструмент GraphQL включает полную справочную информацию по схеме, поэтому ИИ-модель может составлять запросы без необходимости в отдельной документации.

Быстрый старт

Вариант A: npx (рекомендуется — установка не требуется)

npx -y @tacit/mcp-server

Просто укажите на него в вашем MCP-клиенте (см. конфигурацию ниже). Никакого клонирования или сборки.

Вариант B: Клонирование и сборка

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

Вам понадобится API-ключ Tacit. Получите его на панели управления по адресу app.betacit.com в разделе Site Settings > API Keys.

Способы подключения

1. Транспорт Stdio (локальный, по умолчанию)

Стандартный метод — MCP-клиент запускает сервер как дочерний процесс. Лучше всего подходит для индивидуального использования на вашем компьютере.

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %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

Добавьте в .mcp.json в вашем проекте:

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

Cursor

Добавьте в .cursor/mcp.json:

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

2. Потоковый HTTP-транспорт (удаленный)

Запустите сервер как постоянную HTTP-службу. Лучше всего подходит для команд, облачных развертываний и сред, где пользователи не могут установить Node.js локально.

# 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

По умолчанию сервер прослушивает http://0.0.0.0:3001/mcp.

Подключение из любого MCP-клиента

Укажите клиенту URL сервера с токеном bearer:

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

HTTP-конфигурация

Проверка работоспособности

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

3. OAuth 2.1 (корпоративный)

Для производственных развертываний, где вы хотите, чтобы пользователи проходили аутентификацию через процесс входа в Tacit, а не управляли API-ключами:

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

Это обеспечивает:

• Динамическую регистрацию клиентов — MCP-клиенты регистрируются автоматически

• Код авторизации + PKCE — пользователи входят через веб-интерфейс Tacit

• Обновление токенов — сессии остаются активными без повторной аутентификации

• Отзыв токенов — чистое завершение сессии

MCP-клиенты, поддерживающие OAuth (например, Claude Desktop), автоматически обнаружат конфигурацию аутентификации через конечную точку метаданных .well-known/oauth-authorization-server.

4. Docker

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

Подключайтесь, используя конфигурацию HTTP-транспорта выше.

Попробуйте

После подключения задавайте ИИ-ассистенту вопросы, например:

• "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?"

Переменные окружения

Разработка

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

Лицензия

MIT