Skip to main content
Glama

veyra-notes

タグフィルタリングと全文検索機能を備えた、AIエージェント向けの永続的なメモシステムMCPツールです。読み取りは常に無料です。書き込み操作にはVeyraコミットモードの認証が必要です。

概要

veyra-notesは、SQLiteをバックエンドとした信頼性の高いメモ作成レイヤーをAIエージェントに提供します。エージェントは自由にメモの読み取り、一覧表示、検索を行うことができます。メモの作成、更新、削除はVeyraコミットモードによって保護されており、意図的で説明責任のある書き込みを保証します。

Related MCP server: Bruin

インストール

npm install
npm run build

メモは~/.veyra-notes/data.dbに保存され、初回実行時に自動的に作成されます。

MCP設定 (Claude Desktop)

claude_desktop_config.jsonに以下を追加してください:

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

ツール

ツール

入力

クラス

価格

list_notes

{ tag?, limit? }

無料

get_note

{ id }

無料

search_notes

{ query }

無料

create_note

{ title, content, tags?, veyra_token? }

A

€0.005

update_note

{ id, content?, title?, veyra_token? }

A

€0.005

delete_note

{ id, veyra_token? }

B

€0.02

使用例

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

// List all notes
{ "tool": "list_notes", "arguments": {} }

// List notes by tag
{ "tool": "list_notes", "arguments": { "tag": "project-x" } }

// Get a specific note
{ "tool": "get_note", "arguments": { "id": "1712345678-abc1234" } }

// Search across title, content, and tags
{ "tool": "search_notes", "arguments": { "query": "meeting notes" } }

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

// Create a note
{
  "tool": "create_note",
  "arguments": {
    "title": "Sprint Planning",
    "content": "Goals for this sprint: ...",
    "tags": "work,planning",
    "veyra_token": "vt_..."
  }
}

// Update a note
{
  "tool": "update_note",
  "arguments": {
    "id": "1712345678-abc1234",
    "content": "Updated content...",
    "veyra_token": "vt_..."
  }
}

// Delete a note
{
  "tool": "delete_note",
  "arguments": {
    "id": "1712345678-abc1234",
    "veyra_token": "vt_..."
  }
}

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

{
  "error": "VeyraCommitRequired",
  "message": "Write operations require Veyra commit mode.",
  "currentMode": "open",
  "requiredMode": "commit",
  "transitionStrategy": "authorize_then_retry_with_x_veyra_token",
  "provider": "veyra",
  "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-notesは書き込みを実行する前に、@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-tasks

タスク管理

npm i -g veyra-tasks

veyra-snippets

コードスニペットストレージ

npm i -g veyra-snippets

veyra-bookmarks

ブックマークマネージャー

npm i -g veyra-bookmarks

veyra-contacts

連絡先管理

npm i -g veyra-contacts

veyra-forms

フォームビルダー

npm i -g veyra-forms

veyra-webhooks

Webhook送信

npm i -g veyra-webhooks

SDK: npm install @veyrahq/sdk-node ウェブサイト: veyra.to

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.
    1 npm
    2
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP server for a full-stack note-taking application, exposing CRUD tools for notes with SSE transport for AI agent integration.
    1
    -
  • A
    license
    A
    quality
    A
    maintenance
    MCP server for managing a local, domain-agnostic knowledge base using Markdown notes with frontmatter. Enables AI agents to capture, read, search, link, and maintain notes with atomic writes and privacy controls.
    13
    MIT