veyra-bookmarks

Una herramienta MCP de gestión de marcadores y enlaces para agentes de IA, con filtrado por etiquetas, categorías y búsqueda de texto completo. Las lecturas son siempre gratuitas. Las operaciones de escritura requieren autorización del modo commit de Veyra.

Descripción general

veyra-bookmarks proporciona a los agentes de IA una biblioteca de enlaces persistente respaldada por SQLite. Los agentes pueden navegar y buscar marcadores libremente. Guardar, actualizar y eliminar requiere el modo commit de Veyra.

Related MCP server: mcp-bookmark-server

Instalación

npm install
npm run build

Los datos se almacenan en ~/.veyra-bookmarks/data.db, creado automáticamente en la primera ejecución.

Configuración de MCP (Claude Desktop)

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

Herramientas

Ejemplos

Lectura (no se necesita token)

// List all bookmarks
{ "tool": "list_bookmarks", "arguments": {} }

// Filter by category
{ "tool": "list_bookmarks", "arguments": { "category": "research" } }

// Search by keyword
{ "tool": "search_bookmarks", "arguments": { "query": "typescript" } }

Escritura (se requiere token de Veyra)

// Save a bookmark
{
  "tool": "save_bookmark",
  "arguments": {
    "url": "https://www.typescriptlang.org/docs/",
    "title": "TypeScript Docs",
    "tags": "typescript,docs,reference",
    "category": "development",
    "veyra_token": "vt_..."
  }
}

// Update tags/category
{
  "tool": "update_bookmark",
  "arguments": {
    "id": "1712345678-abc1234",
    "tags": "typescript,docs,pinned",
    "veyra_token": "vt_..."
  }
}

// Delete
{
  "tool": "delete_bookmark",
  "arguments": { "id": "1712345678-abc1234", "veyra_token": "vt_..." }
}

Respuesta de error cuando falta el token

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

Cómo funciona Veyra

Veyra es una capa de autorización de modo commit para agentes de IA. Cuando un agente intenta una escritura:

1. El agente llama a la herramienta sin veyra_token → recibe VeyraCommitRequired con authorize_endpoint.

2. El agente/usuario llama al endpoint de autorización para obtener un token.

3. El agente vuelve a intentarlo con veyra_token configurado.

4. veyra-bookmarks verifica el token a través de @veyrahq/sdk-node antes de ejecutar la acción.

Consulta veyra.to para obtener la documentación completa.

Licencia

MIT

Paquete alojado (recomendado)

Prefiera el paquete alojado para una integración de una sola URL:

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

Una URL. 48 herramientas. 24 lecturas gratuitas. 24 escrituras protegidas.

Paquete alojado: https://mcp.veyra.to/sse

Manifiesto del paquete: https://mcp.veyra.to/.well-known/veyra-pack.json

Utilice el paquete alojado cuando desee la ruta de integración MCP más rápida en todas las familias de herramientas de Veyra. Utilice este paquete independiente cuando desee específicamente esta herramienta por sí sola.

Parte del ecosistema Veyra

Veyra es el modo commit para acciones de agentes de IA en producción. Todas las herramientas: lecturas gratuitas, escrituras requieren el modo commit de Veyra.

SDK: npm install @veyrahq/sdk-node Sitio web: veyra.to