veyra-contacts

AIエージェント向けの連絡先管理MCPツール。名前、メールアドレス、電話番号、会社名を保存・検索できます。連絡先データはビジネスにおいて極めて重要であるため、すべての書き込み操作はクラスBであり、Veyraのコミットモード認証が必要です。

概要

veyra-contactsは、SQLiteをバックエンドとした永続的な連絡先データベースをAIエージェントに提供します。読み取りは無料です。すべての変更操作（作成、更新、削除）は、連絡先データがビジネスにおいて重要であり、誤った書き込みから保護する必要があるため、クラス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