Skip to main content
Glama
veyra-forms
by Aquariosan

veyra-forms

一个面向 AI 智能体的表单和调查构建 MCP 工具。定义带有类型化字段的表单,收集结构化响应,并查询结果。读取始终免费。写入操作需要 Veyra 提交模式授权。

概述

veyra-forms 允许 AI 智能体以编程方式创建表单、提交响应并读取结果——所有数据均由 SQLite 支持。表单创建和响应提交属于 B 类操作。

Related MCP server: veyra-contacts

安装

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"]
    }
  }
}

工具

工具

输入

类

价格

list_forms

{}

—

免费

get_form

{ form_id }

—

免费

get_responses

{ form_id }

—

免费

create_form

{ title, fields: [{name, type, required?}], veyra_token? }

B

€0.02

submit_response

{ form_id, data: {}, veyra_token? }

B

€0.02

delete_form

{ form_id, veyra_token? }

B

€0.02

字段类型

任何字符串均可作为 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 是面向 AI 智能体的提交模式授权层。当智能体尝试写入时:

  1. 智能体在不带 veyra_token 的情况下调用工具 → 收到包含 authorize_endpoint 的 VeyraCommitRequired 错误。

  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

当您希望在所有 Veyra 工具系列中实现最快的 MCP 集成路径时,请使用托管包。 当您特别需要单独使用此工具时,请使用此独立包。

Veyra 生态系统的一部分

Veyra 是生产级 AI 智能体操作的提交模式。 所有工具:读取免费,写入需要 Veyra 提交模式。

工具

描述

安装

veyra-memory

键值存储

npm i -g veyra-memory

veyra-notes

带标签的笔记记录

npm i -g veyra-notes

veyra-tasks

任务管理

npm i -g veyra-tasks

veyra-snippets

代码片段存储

npm i -g veyra-snippets

veyra-bookmarks

书签管理器

npm i -g veyra-bookmarks

veyra-contacts

联系人管理

npm i -g veyra-contacts

veyra-webhooks

Webhook 发送器

npm i -g veyra-webhooks

SDK: npm install @veyrahq/sdk-node 网站: veyra.to

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Bookmark manager for AI agents with tags, categories, and full-text search. Reads are free, writes require Veyra commit mode.
      4 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to create local web forms with unlimited brainstorming questions and retrieve user answers as JSON, including support for file uploads.
      MIT