Skip to main content
Glama
deenesjakoruzh
Aquariosan

veyra-contacts

by Aquariosan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

veyra-contacts

一个面向 AI 代理的联系人管理器 MCP 工具。用于存储和查询姓名、电子邮件、电话号码和公司信息。联系人数据属于业务关键型数据 —— 所有写入操作均为 B 类，且需要 Veyra 提交模式授权。

概述

veyra-contacts 为 AI 代理提供了一个由 SQLite 支持的持久化联系人数据库。读取操作免费。所有变更操作（创建、更新、删除）均为 B 类（€0.02），因为联系人数据属于业务关键型数据，必须防止意外写入。

Related MCP server: veyra-forms

安装

npm install
npm run build

数据存储在 ~/.veyra-contacts/data.db 中，首次运行时会自动创建。

MCP 配置 (Claude Desktop)

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

工具

工具

输入

类别

价格

list_contacts

{ tag?, company? }

—

免费

get_contact

{ id }

—

免费

search_contacts

{ query }

—

免费

create_contact

{ name, email?, phone?, company?, tags?, veyra_token? }

B

€0.02

update_contact

{ id, name?, email?, veyra_token? }

B

€0.02

delete_contact

{ id, veyra_token? }

B

€0.02

所有写入操作均为 B 类，因为联系人数据属于业务关键型数据。

示例

读取（无需令牌）

// List all contacts
{ "tool": "list_contacts", "arguments": {} }

// Filter by company
{ "tool": "list_contacts", "arguments": { "company": "Acme Corp" } }

// Search across name, email, company, tags
{ "tool": "search_contacts", "arguments": { "query": "alice" } }

// Get a specific contact
{ "tool": "get_contact", "arguments": { "id": "1712345678-abc1234" } }

写入（需要 Veyra 令牌 — B 类）

// Create a contact
{
  "tool": "create_contact",
  "arguments": {
    "name": "Alice Müller",
    "email": "alice@example.com",
    "phone": "+49 123 456789",
    "company": "Acme Corp",
    "tags": "customer,vip",
    "veyra_token": "vt_..."
  }
}

// Update a contact
{
  "tool": "update_contact",
  "arguments": {
    "id": "1712345678-abc1234",
    "email": "alice.new@example.com",
    "veyra_token": "vt_..."
  }
}

// Delete a contact
{
  "tool": "delete_contact",
  "arguments": { "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-contacts 在执行操作前通过 @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-forms

表单构建器

npm i -g veyra-forms

veyra-webhooks

Webhook 发送器

npm i -g veyra-webhooks

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers