Vrymdor AI Node

本地服务

vrymdor.com安全01 天前更新

关于 Vrymdor AI Node

Vrymdor AI Node 是将 Agent 工具调用和 LLM 请求经由 Vrymdor 节点转发的 Python 客户端，面向使用该服务策略与检查机制的团队。每次调用都会检查 Agent 身份和状态、清除个人信息与密钥、签署请求，并生成仅含元数据的审计记录。

主要功能

01清除个人信息和密钥
02经由节点转发工具调用
03经由节点发送 LLM 请求
04执行 Agent 与策略检查
05记录仅含元数据的审计条目

适用场景

01在工具调用前移除电子邮件地址
02限制 Agent 可使用的工具
03通过节点转发 LLM 请求
04查看过往请求的元数据

MCP 相关

软件包包含 `vrymdor-mcp`，作为桌面 MCP 客户端使用的本地桥接程序。它将 MCP 消息转发到配置的节点，并自动续期 Agent 令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "ernesthausmann15-vrymdor": {
      "command": "uvx",
      "args": [
        "vrymdor-node"
      ],
      "env": {
        "VRYMNOX_NODE_URL": "<VRYMNOX_NODE_URL>",
        "VRYMNOX_AGENT_ID": "<VRYMNOX_AGENT_ID>",
        "VRYMNOX_AGENT_SECRET": "<VRYMNOX_AGENT_SECRET>"
      }
    }
  }
}

启动命令uvx vrymdor-node

需要配置的环境变量

VRYMNOX_NODE_URLYour Node Host URL from the Vrymdor dashboard, for example https://node.vrymdor.com/t/abc123def456

VRYMNOX_AGENT_IDThe Agent ID (agt_...) from AI agents in the Vrymdor dashboard

VRYMNOX_AGENT_SECRET密钥The Agent Secret (vrym_agent_...) shown once when you add the agent

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypivrymdor-node1.1.0stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

vrymdor-node

Vrymnox Systems LLC 开发的 Vrymdor AI Node 的 Python 客户端。每次调用都会经过你的节点检查：Agent 的身份和状态、你的策略、个人身份信息（PII）和机密信息的移除、签名请求，以及仅包含元数据的审计记录。一个模块，一个依赖（httpx）。

安装

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

使用

你需要节点地址，以及在 Vrymdor 应用中注册的 Agent（AI agents，Register an agent）。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

拒绝请求时会引发 VrymnoxError，其中包含稳定的 code（例如 tool_not_allowed、rate_limited、agent_stopped）和 retryable。策略拦截某项操作时会引发 VrymnoxHeld（代码为 held_by_policy）：该操作不会执行，且被拦截的操作永远不会获准执行。请修改策略以允许该操作。

文档：https://docs.vrymdor.com/ai-node.html

MCP：Claude Desktop、Cursor 和 VS Code，无需 Docker

此软件包包含 vrymdor-mcp，这是桌面 MCP 客户端以本地命令启动的桥接程序。它会将每条 MCP 消息转发至你的节点，并自动续期 Agent 的令牌。最简单的运行方式是使用 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"）。

先测试 Agent（会打印“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 启动命令时不会使用 shell 的 PATH），请在 command 中填入完整路径：运行 which uvx（macOS、Linux）或 where uvx（Windows）得到的输出。