Vrymdor AI Node

vrymdor-node

Vrymnox Systems LLC の Vrymdor AI Node 用 Python クライアントです。すべての呼び出しは、ノードによるチェックを経由します。エージェントの ID とステータス、ポリシー、PII（個人を特定できる情報）とシークレットの除去、署名付きリクエスト、メタデータのみの監査記録が含まれます。モジュールは 1 つ、依存関係は 1 つ（httpx）です。

インストール

pip install vrymdor-node                 # the client
pip install "vrymdor-node[langchain]"    # plus LangChain tools
pip install "vrymdor-node[llamaindex]"   # plus LlamaIndex tools

使い方

ノードのアドレスと、Vrymdor アプリ（AI agents、Register an agent）に登録したエージェントが必要です。 エージェントのシークレットは一度だけ表示されます。

from vrymnox_node import VrymnoxNode

node = VrymnoxNode("http://vrymdor-node:8080", agent_id="agt_...", agent_secret="vrym_agent_...")

node.sanitize("Customer [email protected] called")         # "Customer [REDACTED:EMAIL] called"
node.tool("github", "create_issue", {"title": "Login fails"})
node.llm("anthropic", "v1/messages", {"model": "...", "messages": [...]})

tools = node.langchain_tools()     # one LangChain StructuredTool per tool your policy allows
tools = node.llamaindex_tools()    # the same, as LlamaIndex FunctionTools

拒否された場合は、安定した code（例：tool_not_allowed、rate_limited、 agent_stopped）と retryable を含む VrymnoxError が発生します。ポリシーによって保留されたアクションでは、 VrymnoxHeld（コード held_by_policy）が発生します。そのアクションは実行されておらず、保留されたアクションが解除されることはありません。実行を許可するようにポリシーを変更してください。

ドキュメント：https://docs.vrymdor.com/ai-node.html

MCP：Claude Desktop、Cursor、VS Code（Docker 不要）

このパッケージには vrymdor-mcp が含まれています。これはデスクトップ MCP クライアントがローカルコマンドとして起動するブリッジです。各 MCP メッセージをノードに中継し、エージェントのトークンを自動的に更新します。最も簡単な実行方法は uvx です。対応する Python も自動で取得されます。まず uv を一度インストールしてください（macOS と Linux：curl -LsSf https://astral.sh/uv/install.sh | sh； Windows PowerShell：powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"）。

まずエージェントをテストしてください（「Connected: ...」または接続できない理由が表示されます）。

VRYMNOX_NODE_URL=https://node.vrymdor.com/t/abc123def456 VRYMNOX_AGENT_ID=agt_... \
  VRYMNOX_AGENT_SECRET=vrym_agent_... uvx --from vrymdor-node vrymdor-mcp --check

Claude Desktop（claude_desktop_config.json）と Cursor（mcp.json）：

{
  "mcpServers": {
    "vrymdor": {
      "command": "uvx",
      "args": ["--from", "vrymdor-node", "vrymdor-mcp"],
      "env": {
        "VRYMNOX_NODE_URL": "https://node.vrymdor.com/t/abc123def456",
        "VRYMNOX_AGENT_ID": "agt_...",
        "VRYMNOX_AGENT_SECRET": "vrym_agent_..."
      }
    }
  }
}

VS Code（.vscode/mcp.json）：同じブロックを "servers" の下に置き、"type": "stdio" を追加します。

クライアントが uvx を見つけられないと表示する場合（macOS の Claude Desktop はシェルの PATH を使わずにコマンドを起動します）、command にフルパスを指定してください。which uvx（macOS、Linux）または where uvx（Windows）の出力を使用します。

ライセンス

MIT。Vrymdor AI Node 自体は、Vrymnox との契約に基づき別途ライセンスされています。

ライセンスと利用規約

Copyright (c) 2026 Vrymnox Systems LLC. このクライアントは、MIT License（LICENSE）の下でオープンソースとして公開されています。接続先の Vrymdor AI Node サービスの利用には、Vrymdor Master Subscription Agreement （https://vrymdor.com/msa）および、登録時に同意する契約一式に含まれる Acceptable Use Policy が適用されます。