veyra-contacts

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

概述

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

安装

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 代理的提交模式授权层。当代理尝试写入时：

代理在不带 veyra_token 的情况下调用工具 → 收到包含 authorize_endpoint 的 VeyraCommitRequired 响应。
代理/用户调用授权端点以获取令牌。
代理使用设置好的 veyra_token 重试。
veyra-contacts 在执行操作前通过 @veyrahq/sdk-node 验证令牌。

请参阅 veyra.to 获取完整文档。

许可证

MIT

veyra-contacts

veyra-contacts

概述

安装

MCP 配置 (Claude Desktop)

工具

示例

读取（无需令牌）

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

缺少令牌时的错误响应

Veyra 的工作原理

许可证

Resources

Latest Blog Posts

MCP directory API