veyra-bookmarks

AIエージェント向けのブックマークおよびリンク管理MCPツールです。タグフィルタリング、カテゴリ分け、全文検索機能を備えています。読み取りは常に無料です。書き込み操作にはVeyraのコミットモード認証が必要です。

概要

veyra-bookmarksは、SQLiteをバックエンドとした永続的なリンクライブラリをAIエージェントに提供します。エージェントは自由にブックマークを閲覧・検索できます。保存、更新、削除にはVeyraコミットモードが必要です。

インストール

npm install
npm run build

データは~/.veyra-bookmarks/data.dbに保存され、初回実行時に自動的に作成されます。

MCP設定 (Claude Desktop)

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

ツール

ツール	入力	クラス	価格
`list_bookmarks`	`{ tag?, category? }`	—	無料
`get_bookmark`	`{ id }`	—	無料
`search_bookmarks`	`{ query }`	—	無料
`save_bookmark`	`{ url, title?, tags?, category?, veyra_token? }`	A	€0.005
`update_bookmark`	`{ id, tags?, category?, veyra_token? }`	A	€0.005
`delete_bookmark`	`{ id, veyra_token? }`	B	€0.02

使用例

読み取り (トークン不要)

// List all bookmarks
{ "tool": "list_bookmarks", "arguments": {} }

// Filter by category
{ "tool": "list_bookmarks", "arguments": { "category": "research" } }

// Search by keyword
{ "tool": "search_bookmarks", "arguments": { "query": "typescript" } }

書き込み (Veyraトークンが必要)

// Save a bookmark
{
  "tool": "save_bookmark",
  "arguments": {
    "url": "https://www.typescriptlang.org/docs/",
    "title": "TypeScript Docs",
    "tags": "typescript,docs,reference",
    "category": "development",
    "veyra_token": "vt_..."
  }
}

// Update tags/category
{
  "tool": "update_bookmark",
  "arguments": {
    "id": "1712345678-abc1234",
    "tags": "typescript,docs,pinned",
    "veyra_token": "vt_..."
  }
}

// Delete
{
  "tool": "delete_bookmark",
  "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-bookmarksがアクションを実行する前に、@veyrahq/sdk-nodeを介してトークンを検証します。

詳細なドキュメントについてはveyra.toを参照してください。

ライセンス

MIT

veyra-bookmarks

veyra-bookmarks

概要

インストール

MCP設定 (Claude Desktop)

ツール

使用例

読み取り (トークン不要)

書き込み (Veyraトークンが必要)

トークンがない場合のエラーレスポンス

Veyraの仕組み

ライセンス

Resources

Latest Blog Posts

MCP directory API