Voris
Voris privacy-native web analytics for AI agents: query metrics & citations, scaffold tracking.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
@voris-ai/mcpclaude mcp add voris -e 'VORIS_API_KEY=<your voris_api_key>' -- npx -y @voris-ai/mcp@0.0.2
{
"mcpServers": {
"voris": {
"command": "npx",
"args": [
"-y",
"@voris-ai/mcp@0.0.2"
],
"env": {
"VORIS_API_KEY": "<your voris_api_key>"
}
}
}
}
متغيرات البيئة
VORIS_API_KEYإلزامي سري Your Voris MCP API key. Generate one in the Voris dashboard under Settings > AI Connections.
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
@voris-ai/mcp
voris-mcp — a thin stdio ⇄ HTTPS proxy that connects a local MCP client (Claude Desktop, an editor agent, a CLI) to the hosted Voris MCP server at https://mcp.voris.ai/mcp.
It forwards JSON-RPC messages verbatim between the client's stdio channel and the hosted endpoint over Streamable HTTP. It contains no tool logic and no database access — all enforcement (authentication, scopes, rate limits, audit) lives in the hosted server. One connection is scoped to exactly one site, by your key.
Usage
Your MCP client launches voris-mcp as a subprocess and speaks MCP over its stdin/stdout. Provide your key via the environment:
VORIS_API_KEY=vor_mcp_… voris-mcp
Example Claude Desktop configuration:
{
"mcpServers": {
"voris": {
"command": "voris-mcp",
"env": { "VORIS_API_KEY": "vor_mcp_…" }
}
}
}
Options
VORIS_API_KEY(required) — your Voris MCP connection key, generated in Settings → AI Connections. It is sent asAuthorization: Bearer …to the hosted endpoint. If it is unset,voris-mcpwrites a message to stderr and exits with code1.--endpoint <url>— override the hosted endpoint (defaulthttps://mcp.voris.ai/mcp). Mainly for local development; also accepts--endpoint=<url>.
All diagnostics are written to stderr; stdout carries only the MCP protocol stream, so it stays clean for the client.
Status
This release does not publish voris-mcp to npm. The package is built and tarball-tested here; public npm distribution ships in the next phase (A042). Until then, generate your key and copy the hosted-connection snippet from the Voris dashboard.
الأسئلة الشائعة
ما هو Voris؟
Voris privacy-native web analytics for AI agents: query metrics & citations, scaffold tracking.
كيف أثبّت Voris؟
يعمل على جهازك. في Claude Code: claude mcp add voris -e 'VORIS_API_KEY=<your voris_api_key>' -- npx -y @voris-ai/mcp@0.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Voris إلى مفتاح API؟
نعم. يتطلب VORIS_API_KEY، وتضبطها في إعداداته.
هل Voris مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Voris؟
ينشره Rocket-Venture-Labs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.