arachne-mcp

🕷️ Arachne MCP 服务

🌐 English · 🇧🇷 Português

通过 Arachne API 提供 49 个 MCP 工具，涵盖网页抓取、浏览器自动化、计算机视觉、音频转录、RAG、社交舆情研究和视觉回归测试（VRT）——Oito Olhos（蜘蛛的八只眼睛）。

由 Arachne 提供支持。适用于 Claude Desktop、Cursor、Codex CLI、Hermes 及任何 MCP 客户端。

✨ 工具（49）

🔍 网页与数据

工具	功能	最适用于
arachne_search	通过 DuckDuckGo 搜索网页	调研、收集潜在客户
arachne_scrape	从 URL 提取干净的 Markdown 内容	静态页面、博客、文档
arachne_extract	提取任意格式的内容（音频、视频、PDF、YouTube）	瑞士军刀
arachne_browser_extract	使用具备 Cloudflare/CAPTCHA 绕过能力的真实浏览器	会拦截抓取工具的网站
arachne_browser_run	执行浏览器操作（点击、输入、登录）	表单自动化
arachne_screenshot	截取 URL 的屏幕截图（整页或视口）	视觉证据
arachne_record	录制页面屏幕视频（.webm）	交互、演示
arachne_torrent_extract	从巴西种子网站提取磁力链接	获取种子
arachne_download	通用下载（URL、仓库、PyPI、npm）	获取任意制品
arachne_query	查询你的 RAG 知识库	使用你自己的数据构建聊天机器人

🔍 社交舆情研究

工具	功能	最适用于
arachne_social_research	搜索人们真正的看法（HN/Reddit/YouTube，最近 N 天）+ 通过本地 VLM 进行 AI 判断	炒作与现实、投诉、市场情绪

👁️ 视觉与音频

工具	功能	最适用于
arachne_vision	图像分析：OCR、颜色、人脸、AI 描述	从照片中提取文本
arachne_screenshot_vision	截屏 + 完整视觉处理流程	视觉检查页面
arachne_pdf_vision	从 PDF 中提取图像 + 视觉分析	扫描版 PDF
arachne_analyze_video	视频元数据：颜色、OCR、几何信息、VQA、音频	理解视频
arachne_transcribe	使用 Whisper 转录音频/视频/YouTube 内容	播客、会议、视频

🕷️ Oito Olhos — 视觉回归测试（VRT）

工具	功能	最适用于
arachne_visual_snapshot	捕获 URL → 创建基线（首次运行）或进行比较	幂等视觉测试
arachne_visual_diff	与基线比较 → 差异 + 语义判定	部署后验证
arachne_visual_gates	确定性审计：溢出、文本碰撞、JS 错误	无需密钥、无需基线
arachne_visual_report	测试套件 → HTML 并排对比	汇总审查
arachne_visual_approve	将当前状态设为新基线	接受预期变更
arachne_visual_list	列出基线 + 状态	监控现有内容
arachne_visual_video	视频 VRT：录制屏幕视频并进行比较（动画）	悬停、轮播、过渡
arachne_visual_video_report	视频套件 → 交互式 HTML 报告	动画回归审查

🤖 桌面与 Agent 式操作

工具	功能	最适用于
arachne_desktop	桌面控制（窗口、输入、按键、点击）	操作系统自动化
arachne_desktop_os	配备 VLM“眼睛”的桌面 Agent 操作（截图 + 描述）	行动前先观察
arachne_observe	截图 + 带编号且可点击的边界框	GUI Agent 导航

📦 GitHub / GitLab / Packages

工具	功能
arachne_repo_download	将 GitHub 仓库下载为 zip 文件（分支／令牌）
arachne_repo_fork	Fork 一个 GitHub 仓库
arachne_repo_forks	按星标数列出 Fork
arachne_repo_index	下载仓库并将其编入 RAG 索引
arachne_releases	列出带有资源文件的 GitHub 发行版
arachne_release_download	下载发行版资源文件
arachne_pypi_download	下载 PyPI 软件包（sdist／wheel）
arachne_npm_download	下载 npm 软件包 tarball
arachne_gitlab_download	下载 GitLab 项目归档
arachne_github_trending	GitHub 热门仓库和开发者（按时间段／语言筛选，零成本）
arachne_github_user_prs	列出用户创建的 PR（可按 since／until 筛选）
arachne_github_user_activity	查看用户的月度活动和事件类型
arachne_github_repo_metadata	查看完整的仓库元数据（星标／Fork／问题／许可证）

🧠 代码知识图谱

工具	功能
code_graph	探索代码结构：统计数据、搜索、路由、文件、依赖项
kg_context	排序后的 BFS 代码上下文（约 2K 个令牌）
kg_communities	社区检测（Leiden／greedy）
kg_god_nodes	影响力最大的代码实体（PageRank）
kg_watch	Git 监视器 — 增量变更检测

🧭 实用工具

工具	功能
arachne_capabilities	自动发现功能
arachne_ping	健康检查
arachne_metrics	服务指标（CPU、RAM、磁盘）
arachne_plan	目标分析 → 工具链建议
arachne_calc	安全的数学计算器（基于 AST 沙箱）
arachne_format_converter	通用格式转换器（支持 65+ 种格式）
arachne_sandbox_status	检查 ai-jail 沙箱是否可用

使用本地 LLM 进行 VRT： Oito Olhos 使用像素差异 + DOM 配对 + CLIP 语义筛查 + 本地 VLM（通过 Douglas 使用 Qwen2.5-VL，Samuel 镜像作为备用）——将变更分类为 regression | expected | noise，并在检测到 Bug 时提供修复建议（CORRECAO:）。无需第三方 API 密钥即可生成判定结果。

使用本地 AI 评审进行社交研究： arachne_social_research 会搜索过去 N 天内的 Hacker News（Algolia）、Reddit（JSON API + browser_agent/Camoufox 备用方案）和 YouTube（yt-dlp），根据实际参与度（赞成票／积分／浏览量）进行评分，并使用本地 VLM 生成炒作与现实对比报告（无需第三方 API 密钥）。

🚀 快速开始

1. 获取 API 密钥

在 arachne.seu.pet/dev 创建一个（免费计划：每月 500 次请求）。

2. 在 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. 或直接运行

pip install arachne-mcp
export ARACHNE_API_KEY="arn_your_key_here"
python3 -m arachne_mcp

🪟 Windows 安装（开箱即用）

arachne-mcp 是一个纯 Python 客户端（仅依赖 httpx）——没有仅限 Linux 的 依赖项，也不需要 WSL。可在 Windows 上使用以下命令安装：

pip install arachne-mcp

然后使用控制台脚本入口点在任意 MCP 客户端中配置它 （安装后，arachne-mcp 会加入 PATH）：

{
  "mcpServers": {
    "arachne": {
      "command": "arachne-mcp",
      "args": [],
      "env": {
        "ARACHNE_API_KEY": "arn_your_key_here",
        "ARACHNE_API_URL": "https://arachne.seu.pet"
      }
    }
  }
}

⚠️ 不要将 command 指向 Linux 路径（例如 /home/user/.../venv/bin/arachne-mcp）—— 该路径只存在于运行 Arachne 服务的机器上。在 Windows（以及其他任何 客户端机器）上，请使用 pip 软件包 + API 密钥：服务会在 https://arachne.seu.pet 后台处理所有繁重工作（浏览器、VLM、视觉、RAG）。

📡 架构

MCP 服务是一个轻量级代理：它会将每次工具调用转发到 Arachne API （POST /api/mcp/proxy），由 API 在服务端执行工具并返回结果。 这样客户端就能保持轻量（仅依赖 httpx），而所有繁重工作——浏览器、VLM、 视觉、RAG——都在 Arachne 服务上运行。

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

🔐 安全

• API 密钥身份验证：每个请求都会携带 X-API-Key（在 /dev 创建）
• 速率限制由服务端按计划执行
• 客户端不会运行代码——代理只会转发参数