🕷️ Arachne MCP Server
🌐 English · 🇧🇷 Português
49 MCP tools for web scraping, browser automation, computer vision, audio transcription, RAG, Social Sentiment Research, and Visual Regression Testing (VRT) — the Oito Olhos (Spider's Eight Eyes) — all through the Arachne API.
Backed by Arachne. Works with Claude Desktop, Cursor, Codex CLI, Hermes, and any MCP client.
✨ Tools (49)
🔍 Web & Data
🔍 Social Sentiment Research
👁️ Vision & Audio
🕷️ Oito Olhos — Visual Regression Testing (VRT)
🤖 Desktop & Agentic
📦 GitHub / GitLab / Packages
🧠 Code Knowledge Graph
🧭 Utilities
VRT with local LLM: Oito Olhos uses pixel diff + DOM pairing + CLIP semantic triage + local VLM (Qwen2.5-VL via Douglas, Samuel mirror fallback) — classifying changes as
regression | expected | noise, with a fix suggestion (CORRECAO:) when it detects a bug. No third-party API key for the verdict.
Social Research with local AI judge:
arachne_social_researchsearches Hacker News (Algolia), Reddit (JSON API + browser_agent/Camoufox fallback) and YouTube (yt-dlp) in the last N days, scores by real engagement (upvotes/points/views), and synthesizes a hype vs reality report with a local VLM (no third-party API keys).
🚀 Quick Start
1. Get an API key
Create one at arachne.seu.pet/dev (Free plan: 500 req/month).
2. Configure in Claude Desktop
{
"mcpServers": {
"arachne": {
"command": "python3",
"args": ["-m", "arachne_mcp"],
"env": {
"ARACHNE_API_KEY": "arn_your_key_here",
"ARACHNE_API_URL": "https://arachne.seu.pet"
}
}
}
}
3. Or run directly
pip install arachne-mcp
export ARACHNE_API_KEY="arn_your_key_here"
python3 -m arachne_mcp
🪟 Windows install (works out of the box)
arachne-mcp is a pure-Python client (only httpx) — no Linux-only
dependencies, no WSL required. Install it on Windows with:
pip install arachne-mcp
Then configure it in any MCP client using the console-script entry point
(arachne-mcp is on your PATH after install):
{
"mcpServers": {
"arachne": {
"command": "arachne-mcp",
"args": [],
"env": {
"ARACHNE_API_KEY": "arn_your_key_here",
"ARACHNE_API_URL": "https://arachne.seu.pet"
}
}
}
}
⚠️ Do not point
commandat a Linux path (e.g./home/user/.../venv/bin/arachne-mcp) — that only exists on the machine where the Arachne server runs. On Windows (and any other client machine) use the pip package + API key: the server does all heavy work (browser, VLM, vision, RAG) behindhttps://arachne.seu.pet.
📡 Architecture
The MCP server is a thin proxy: it forwards each tool call to the Arachne API
(POST /api/mcp/proxy), which executes the tool server-side and returns the result.
This keeps the client light (only httpx), while all heavy work — browser, VLM,
vision, RAG — runs on the Arachne server.
Claude Desktop / Cursor / Codex
│ MCP (stdio)
▼
arachne-mcp (thin proxy, 49 tools)
│ HTTP + X-API-Key
▼
Arachne API (arachne.seu.pet) → executes tool → returns JSON
🔐 Security
- API key auth: every request carries
X-API-Key(create at/dev) - Rate limits enforced server-side per plan
- No code runs client-side — the proxy only forwards arguments