structly-mcp

MCP-сервер для Structly (VisualDB). Запускается через npx без установки Python и uv — в пакете лежит собранный standalone-бинарник (PyInstaller).

Использование

npx -y structly-mcp

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

| Переменная | Описание | |------------|----------| | STRUCTLY_API_URL | URL Structly API. Необязательно — по умолчанию https://structly.elevo.space | | STRUCTLY_API_TOKEN | API-токен из раздела «Интеграции» (обязателен) |

Подключение в MCP-клиенте

Claude Desktop

{
  "mcpServers": {
    "structly": {
      "command": "npx",
      "args": ["-y", "structly-mcp"],
      "env": {
        "STRUCTLY_API_TOKEN": "st_dev_mcp_..."
      }
    }
  }
}

Если Structly развёрнут по другому адресу — укажите его:

{
  "mcpServers": {
    "structly": {
      "command": "npx",
      "args": ["-y", "structly-mcp"],
      "env": {
        "STRUCTLY_API_URL": "https://ваш-домен",
        "STRUCTLY_API_TOKEN": "st_dev_mcp_..."
      }
    }
  }
}

opencode

{
  "mcp": {
    "structly": {
      "type": "local",
      "command": ["npx", "-y", "structly-mcp"],
      "environment": {
        "STRUCTLY_API_TOKEN": "st_dev_mcp_..."
      }
    }
  }
}

Поддерживаемые платформы

Бинарник собирается под каждую ОС отдельно (PyInstaller не кросс-компилирует). GitHub Actions (.github/workflows/build.yml) собирает: Windows x64, macOS arm64, Linux x64.

| Платформа | Бинарник | |-----------|----------| | Windows x64 | platform/win32-x64/structly-mcp.exe | | macOS arm64 (Apple Silicon) | platform/darwin-arm64/structly-mcp | | Linux x64 | platform/linux-x64/structly-mcp |

Intel macOS (darwin-x64) не собирается в CI: GitHub вывел из эксплуатации бесплатные Intel-macOS раннеры. Если нужен Intel-бинарник — соберите на self-hosted Intel Mac и положите в platform/darwin-x64/.

Если бинарника для вашей платформы нет — соберите (см. ../build/README.md) и положите в соответствующую папку, либо запускайте Python-исходник: uv run structly-mcp.