tooltrace

ToolTrace MCP Server

为 AI Agent 提供完整的网页智能工具包。这个 Model Context Protocol 服务可将 Claude Code、Claude Desktop、Cursor、VS Code、Codex、Windsurf 和其他任何 MCP 客户端连接到 ToolTrace API。

每个 ToolTrace 端点对应一个工具：将任意页面抓取为干净的 Markdown、读取元数据和 JSON-LD、提取链接、运行页面 SEO 审核、检测网站的技术栈，以及检查 XML 站点地图。包含免费套餐，无需信用卡。

设置指南： tooltrace.io/mcp

工具

工具	描述
tooltrace_extract	从任意网页提取干净的 Markdown、文本、元数据、链接、JSON-LD 和章节
tooltrace_metadata	获取页面标题、描述、规范 URL、Open Graph 和 Twitter 卡片字段
tooltrace_links	提取所有内部和外部链接及锚文本
tooltrace_schema	提取 JSON-LD 结构化数据（Article、Product、FAQ 等）
tooltrace_seo_audit	运行 SEO 审核，提供评分检查项和建议
tooltrace_tech_stack	检测 CMS、框架、分析工具、CDN、托管服务等
tooltrace_sitemap	检查并解析 XML 站点地图

两种连接方式

托管方式，适用于支持连接器 URL 的客户端。无需安装或更新：

https://mcp.tooltrace.io/mcp

claude mcp add --transport http tooltrace https://mcp.tooltrace.io/mcp \
  --header "Authorization: Bearer your-api-key"

也列于 Smithery。

本地方式，通过 stdio 连接，适用于运行进程的客户端。当客户端 不支持 HTTP，或你希望 API 密钥始终留在自己的 机器上时，请使用此方式。下面是快速入门指南。

两种方式都提供相同的工具，并消耗相同的额度。

快速入门

1. 获取免费 API 密钥

在 tooltrace.io/signup 注册。免费套餐每月包含 1,000 个额度。

2. 安装

npm install -g @tooltrace/mcp-server

3. 配置 MCP 客户端

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code：

claude mcp add tooltrace tooltrace-mcp -e TOOLTRACE_API_KEY=your-api-key

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.tooltrace]
command = "tooltrace-mcp"
env = { TOOLTRACE_API_KEY = "your-api-key" }

Windsurf（mcp_config.json）：

{
  "mcpServers": {
    "tooltrace": {
      "command": "tooltrace-mcp",
      "env": {
        "TOOLTRACE_API_KEY": "your-api-key"
      }
    }
  }
}

**其他任何 MCP 客户端：**通过 stdio 运行 tooltrace-mcp，并设置 TOOLTRACE_API_KEY 环境变量。各客户端的完整设置指南请参见 tooltrace.io/mcp。

使用 npx 运行（无需安装）

TOOLTRACE_API_KEY=your-api-key npx @tooltrace/mcp-server

使用示例

连接后，你的 AI Agent 可以：

• “将这篇博客文章的主要内容提取为 Markdown”
• “competitor.com 使用了哪些技术？”
• “对我们的落地页运行 SEO 审核”
• “获取这个文档页面中的所有链接”
• “提取这个产品页面中的 JSON-LD 架构”
• “检查这个网站的站点地图”

渲染模式

所有工具都支持 render 参数：

• never：快速静态抓取，1 个额度。最适合服务端渲染的页面。
• auto（默认）：从静态抓取开始，必要时在浏览器中渲染。消耗 1 或 5 个额度。
• always：完整的浏览器渲染，5 个额度。适用于 JavaScript 密集型 SPA。

开发

git clone https://github.com/ToolTrace-io/mcp-server.git
cd mcp-server
npm install
npm run build
TOOLTRACE_API_KEY=your-key node dist/index.js

许可证

MIT