Skip to main content
Glama
deenesjakoruzh
Aquariosan

veyra-contacts

by Aquariosan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

veyra-contacts

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

概要

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

ホスト型パック（推奨）

1つのURLで統合できるホスト型パックを推奨します：

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

1つの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