İstekleri gizlilik politikalarını uygulayan güvenli bir düğüm üzerinden yönlendirerek, AI agent araç çağrılarındaki kişisel verileri ve gizli bilgileri maskeler.
Ayrıca bilinen adı ernesthausmann15/vrymdor-node-python, vrymdor-node-python, vrymdor-node
- Yıldızlar
- 0
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- 1.2.2
- Son commit
- 12 Kas 2026
- Lisans
- MIT
Vrymdor AI Node MCP nedir?
Vrymdor AI Node bir MCP sunucusudur. İstekleri gizlilik politikalarını uygulayan güvenli bir düğüm üzerinden yönlendirerek, AI agent araç çağrılarındaki kişisel verileri ve gizli bilgileri maskeler.
Özet, projenin README dosyasından oluşturuldu
Vrymdor AI Node MCP sunucusu hakkında
Hassas bilgilerin AI agent etkileşimleri sırasında korunması, Vrymdor AI Node'un temel işlevidir. Araç çağrılarını yakalayan ve bu çağrılar harici servislere ulaşmadan önce kişisel verileri ve gizli bilgileri temizleyen güvenli bir köprü görevi görür. Geliştiriciler, agent kimliğini ve durumunu doğrulayan merkezi bir düğüm üzerinden istekleri yönlendirerek ve yalnızca meta verilerden oluşan denetim kayıtları oluşturarak gizlilik politikalarını uygulamak için bu yapıyı kullanırlar.
Kurulum için, bir agent ID ve tek seferlik bir agent secret edinmek amacıyla Vrymdor uygulamasında bir agent kaydetmeniz gerekir. Sunucu, uvx komutu kullanılarak Claude Desktop, Cursor veya VS Code gibi masaüstü istemcileri için yerel bir MCP köprüsü olarak çalıştırılabilir. Çalışması için VRYMNOX_NODE_URL, VRYMNOX_AGENT_ID ve VRYMNOX_AGENT_SECRET ortam değişkenlerine ihtiyaç duyar. Sistem, token yenileme işlemini otomatik olarak gerçekleştirir ve eylemler belirlenmiş gizlilik kurallarınızla çakıştığında tool_not_allowed veya held_by_policy gibi spesifik hata kodları sağlar.
Neler yapabilirsiniz
- 1Hassas kullanıcı verilerini gizlemeE-posta adreslerinin maskelendiğinden emin olarak yapay zekadan bir müşteri mesajını işlemesini isteyin.
- 2Agent araç kullanımını denetlemeTüm agent faaliyetlerinin kaydını yalnızca meta verilerden oluşan günlükler aracılığıyla tutun.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Vrymdor AI Node MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıVrymdor AI Node MCP'yi Claude Code içine yükleyin
$ claude mcp add --env VRYMNOX_AGENT_SECRET=<YOUR_VRYMNOX_AGENT_SECRET> --env VRYMNOX_AGENT_ID=<VRYMNOX_AGENT_ID> --env VRYMNOX_NODE_URL=<VRYMNOX_NODE_URL> vrymdor-node-python -- uvx vrymdor-nodeVrymdor AI Node MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"vrymdor-node-python": {
"command": "uvx",
"args": [
"vrymdor-node"
],
"env": {
"VRYMNOX_AGENT_SECRET": "<YOUR_VRYMNOX_AGENT_SECRET>",
"VRYMNOX_AGENT_ID": "<VRYMNOX_AGENT_ID>",
"VRYMNOX_NODE_URL": "<VRYMNOX_NODE_URL>"
}
}
}
}Vrymdor AI Node MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"vrymdor-node-python": {
"type": "stdio",
"command": "uvx",
"args": [
"vrymdor-node"
],
"env": {
"VRYMNOX_AGENT_SECRET": "<YOUR_VRYMNOX_AGENT_SECRET>",
"VRYMNOX_AGENT_ID": "<VRYMNOX_AGENT_ID>",
"VRYMNOX_NODE_URL": "<VRYMNOX_NODE_URL>"
}
}
}
}Vrymdor AI Node MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"vrymdor-node-python": {
"command": "uvx",
"args": [
"vrymdor-node"
],
"env": {
"VRYMNOX_AGENT_SECRET": "<YOUR_VRYMNOX_AGENT_SECRET>",
"VRYMNOX_AGENT_ID": "<VRYMNOX_AGENT_ID>",
"VRYMNOX_NODE_URL": "<VRYMNOX_NODE_URL>"
}
}
}
}Vrymdor AI Node MCP'yi Codex içine yükleyin
~/.codex/config.toml
[mcp_servers.vrymdor-node-python] command = "uvx" args = ["vrymdor-node"] [mcp_servers.vrymdor-node-python.env] VRYMNOX_AGENT_SECRET = "<YOUR_VRYMNOX_AGENT_SECRET>" VRYMNOX_AGENT_ID = "<VRYMNOX_AGENT_ID>" VRYMNOX_NODE_URL = "<VRYMNOX_NODE_URL>"
Vrymdor AI Node MCP'yi Gemini CLI içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"vrymdor-node-python": {
"command": "uvx",
"args": [
"vrymdor-node"
],
"env": {
"VRYMNOX_AGENT_SECRET": "<YOUR_VRYMNOX_AGENT_SECRET>",
"VRYMNOX_AGENT_ID": "<VRYMNOX_AGENT_ID>",
"VRYMNOX_NODE_URL": "<VRYMNOX_NODE_URL>"
}
}
}
}Yapılandırma
VRYMNOX_AGENT_SECRETGerekliGizliThe Agent Secret (vrym_agent_...) shown once when you add the agent
VRYMNOX_AGENT_IDGerekliThe Agent ID (agt_...) from AI agents in the Vrymdor dashboard
VRYMNOX_NODE_URLGerekliYour Node Host URL from the Vrymdor dashboard, for example https://node.vrymdor.com/t/abc123def456
| Ad | Açıklama | Sunucu |
|---|---|---|
| VRYMNOX_AGENT_SECRET | The Agent Secret (vrym_agent_...) shown once when you add the agent | GerekliGizli |
| VRYMNOX_AGENT_ID | The Agent ID (agt_...) from AI agents in the Vrymdor dashboard | Gerekli |
| VRYMNOX_NODE_URL | Your Node Host URL from the Vrymdor dashboard, for example https://node.vrymdor.com/t/abc123def456 | Gerekli |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirernesthausmann15/vrymdor-node-python is public and reachablegithub.com/ernesthausmann15/vrymdor-node-python ↗Geçti
- Paket bu depoyu kaynak olarak gösteriyorvrymdor-node names ernesthausmann15/vrymdor-node-python as sourcepypi.org/project/vrymdor-node/ ↗Geçti
- Derleme kaynağı (Sigstore onayı)Sigstore attestation for vrymdor-nodepypi.org/project/vrymdor-node/ ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-11-14github.com/ernesthausmann15/vrymdor-node-python ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from vrymdor-nodeGeçti
- Pakette ve bağımlılıklarında kritik uyarı yokthe package checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak endpoint MCP el sıkışmasına yanıt veriyorKontrol edilmedi
vrymdor-node
The Python client for the Vrymdor AI Node by Vrymnox Systems LLC. Every call goes through your node's checks: the agent's identity and status, your policy, removal of PII (personally identifiable information) and secrets, a signed request and a metadata-only audit record. One module, one dependency (httpx).
Install
pip install vrymdor-node # the client
pip install "vrymdor-node[langchain]" # plus LangChain tools
pip install "vrymdor-node[llamaindex]" # plus LlamaIndex tools
Use
You need your node's address and an agent registered in the Vrymdor app (AI agents, Register an agent). The agent secret is shown once.
from vrymnox_node import VrymnoxNode
node = VrymnoxNode("http://vrymdor-node:8080", agent_id="agt_...", agent_secret="vrym_agent_...")
node.sanitize("Customer jane@acme.io 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
A refusal raises VrymnoxError with a stable code (for example tool_not_allowed, rate_limited,
agent_stopped) and retryable. An action your policy holds raises VrymnoxHeld (code
held_by_policy): it did not run, and a held action is never released. Change the policy to allow it.
Documentation: https://docs.vrymdor.com/ai-node.html
MCP: Claude Desktop, Cursor and VS Code, no Docker
The package includes vrymdor-mcp, the bridge desktop MCP clients start as a local command. It relays each MCP
message to your node and renews the agent's token by itself. The easiest way to run it is uvx, which also fetches
a matching Python for you: install uv once (macOS and Linux: curl -LsSf https://astral.sh/uv/install.sh | sh;
Windows PowerShell: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex").
Test the agent first (it prints "Connected: ..." or the reason it is not):
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) and 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): the same block under "servers", with "type": "stdio" added.
If the client says it cannot find uvx (Claude Desktop on macOS starts commands without your shell's PATH), put
the full path in command: the output of which uvx (macOS, Linux) or where uvx (Windows).
License
MIT. The Vrymdor AI Node itself is licensed separately under your Vrymnox agreement.
License and terms
Copyright (c) 2026 Vrymnox Systems LLC. This client is open source under the MIT License (LICENSE). Using the Vrymdor AI Node service it connects to is governed by the Vrymdor Master Subscription Agreement (https://vrymdor.com/msa) and the Acceptable Use Policy in the agreement set you accept when you sign up.
Vrymdor AI Node MCP soruları
Vrymdor AI Node MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add --env VRYMNOX_AGENT_SECRET=<YOUR_VRYMNOX_AGENT_SECRET> --env VRYMNOX_AGENT_ID=<VRYMNOX_AGENT_ID> --env VRYMNOX_NODE_URL=<VRYMNOX_NODE_URL> vrymdor-node-python -- uvx vrymdor-node komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Vrymdor AI Node MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Vrymdor AI Node verileri korumak için ne yapar?
Agent kimliğini kontrol eder, politikaları uygular, kişisel olarak tanımlanabilir bilgileri (PII) ve gizli verileri temizler ve meta veri denetim kayıtlarına sahip imzalı istekler oluşturur.
Bir araç çağrısı bir politika tarafından engellenirse ne olur?
Bir ret işlemi belirli bir kodla VrymnoxError fırlatır; eğer politika işlemi durdurursa VrymnoxHeld hatası fırlatılır ve işlem gerçekleştirilmez.