veyra-snippets

Una herramienta MCP de gestión de fragmentos de código persistente para agentes de IA, con filtrado por lenguaje, búsqueda por etiquetas y búsqueda de texto completo en el código. Las lecturas son siempre gratuitas. Las operaciones de escritura requieren autorización del modo de confirmación de Veyra.

Descripción general

veyra-snippets proporciona a los agentes de IA una biblioteca de código fiable respaldada por SQLite. Los agentes pueden explorar y buscar fragmentos libremente. Guardar, actualizar y eliminar fragmentos está protegido por el modo de confirmación de Veyra, lo que garantiza escrituras intencionadas y responsables.

Instalación

npm install
npm run build

Los fragmentos se almacenan en ~/.veyra-snippets/data.db, que se crea automáticamente en la primera ejecución.

Configuración de MCP (Claude Desktop)

Añada lo siguiente a su claude_desktop_config.json:

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

Herramientas

Herramienta	Entrada	Clase	Precio
`list_snippets`	`{ language?, tag? }`	—	GRATIS
`get_snippet`	`{ id }`	—	GRATIS
`search_snippets`	`{ query }`	—	GRATIS
`save_snippet`	`{ title, code, language, tags?, veyra_token? }`	A	0,005 €
`update_snippet`	`{ id, code?, title?, veyra_token? }`	A	0,005 €
`delete_snippet`	`{ id, veyra_token? }`	B	0,02 €

Ejemplos

Lectura (no se necesita token)

// List all snippets
{ "tool": "list_snippets", "arguments": {} }

// List TypeScript snippets
{ "tool": "list_snippets", "arguments": { "language": "typescript" } }

// List snippets by tag
{ "tool": "list_snippets", "arguments": { "tag": "auth" } }

// Get a specific snippet
{ "tool": "get_snippet", "arguments": { "id": "1712345678-abc1234" } }

// Search across title, code, language, and tags
{ "tool": "search_snippets", "arguments": { "query": "debounce" } }

Escritura (se requiere token de Veyra)

// Save a new snippet
{
  "tool": "save_snippet",
  "arguments": {
    "title": "Debounce utility",
    "code": "function debounce(fn, ms) {\n  let timer;\n  return (...args) => {\n    clearTimeout(timer);\n    timer = setTimeout(() => fn(...args), ms);\n  };\n}",
    "language": "javascript",
    "tags": "utility,performance",
    "veyra_token": "vt_..."
  }
}

// Update snippet code
{
  "tool": "update_snippet",
  "arguments": {
    "id": "1712345678-abc1234",
    "code": "// updated code here",
    "veyra_token": "vt_..."
  }
}

// Delete a snippet
{
  "tool": "delete_snippet",
  "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",
  "transitionStrategy": "authorize_then_retry_with_x_veyra_token",
  "provider": "veyra",
  "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 en modo de confirmación para agentes de IA. Cuando un agente intenta una operación de escritura:

El agente llama a la herramienta sin un veyra_token y recibe un error VeyraCommitRequired con un authorize_endpoint.
El agente (o el usuario en su nombre) llama al punto de conexión de autorización para obtener un token.
El agente vuelve a intentar la llamada a la herramienta con el veyra_token configurado.
veyra-snippets verifica el token a través de @veyrahq/sdk-node antes de ejecutar la escritura.

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

Licencia

MIT

veyra-snippets

veyra-snippets

Descripción general

Instalación

Configuración de MCP (Claude Desktop)

Herramientas

Ejemplos

Lectura (no se necesita token)

Escritura (se requiere token de Veyra)

Respuesta de error cuando falta el token

Cómo funciona Veyra

Licencia

Resources

Latest Blog Posts

MCP directory API