veyra-forms

MCP-инструмент для создания форм и опросов для ИИ-агентов. Определяйте формы с типизированными полями, собирайте структурированные ответы и запрашивайте результаты. Чтение всегда бесплатно. Операции записи требуют авторизации в режиме фиксации Veyra.

Обзор

veyra-forms позволяет ИИ-агентам программно создавать формы, отправлять ответы и читать результаты — всё на базе SQLite. Создание форм и отправка ответов являются операциями класса B.

Related MCP server: humansurvey-mcp

Установка

npm install
npm run build

Данные хранятся в ~/.veyra-forms/data.db, файл создается автоматически при первом запуске.

Конфигурация MCP (Claude Desktop)

{
  "mcpServers": {
    "veyra-forms": {
      "command": "node",
      "args": ["/absolute/path/to/veyra-forms/dist/index.js"]
    }
  }
}

Инструменты

Типы полей

Любая строка принимается в качестве type. Распространенные значения: text, email, number, boolean, date, textarea.

Примеры

Чтение (токен не требуется)

// List all forms
{ "tool": "list_forms", "arguments": {} }

// Get a form and its field schema
{ "tool": "get_form", "arguments": { "form_id": "1712345678-abc1234" } }

// Get all responses for a form
{ "tool": "get_responses", "arguments": { "form_id": "1712345678-abc1234" } }

Запись (требуется токен Veyra)

// Create a form
{
  "tool": "create_form",
  "arguments": {
    "title": "Customer Feedback",
    "fields": [
      { "name": "name", "type": "text", "required": true },
      { "name": "email", "type": "email", "required": true },
      { "name": "rating", "type": "number", "required": true },
      { "name": "comment", "type": "textarea" }
    ],
    "veyra_token": "vt_..."
  }
}

// Submit a response
{
  "tool": "submit_response",
  "arguments": {
    "form_id": "1712345678-abc1234",
    "data": {
      "name": "Alice",
      "email": "alice@example.com",
      "rating": 5,
      "comment": "Excellent service!"
    },
    "veyra_token": "vt_..."
  }
}

// Delete a form (also deletes all responses)
{
  "tool": "delete_form",
  "arguments": { "form_id": "1712345678-abc1234", "veyra_token": "vt_..." }
}

Ответ об ошибке при отсутствии токена

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "authorize_endpoint": "https://api.veyra.to/v1/authorize-action",
  "docs_url": "https://veyra.to"
}

Как работает Veyra

Veyra — это уровень авторизации в режиме фиксации для ИИ-агентов. Когда агент пытается выполнить запись:

1. Агент вызывает инструмент без veyra_token → получает VeyraCommitRequired с authorize_endpoint.

2. Агент/пользователь вызывает эндпоинт авторизации для получения токена.

3. Агент повторяет попытку с установленным veyra_token.

4. veyra-forms проверяет токен через @veyrahq/sdk-node перед выполнением действия.

Полную документацию см. на veyra.to.

Лицензия

MIT

Хостинг-пакет (рекомендуется)

Рекомендуем использовать хостинг-пакет для интеграции через один URL:

{
  "mcpServers": {
    "veyra": {
      "url": "https://mcp.veyra.to/sse"
    }
  }
}

Один URL. 48 инструментов. 24 бесплатных чтения. 24 защищенных записи.

Хостинг-пакет: https://mcp.veyra.to/sse

Манифест пакета: https://mcp.veyra.to/.well-known/veyra-pack.json

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

Часть экосистемы Veyra

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

SDK: npm install @veyrahq/sdk-node Веб-сайт: veyra.to