跳到正文
CrawlForge MCP
VS Code

VS Code 集成

借助 CrawlForge MCP 让 GitHub Copilot 智能体模式获得实时网页访问能力。工作区中的 .vscode/mcp.json 或用户配置文件中的 mcp.json，一个块即可添加服务器。

前置条件

VS Code
从 code.visualstudio.com 下载，并安装 GitHub Copilot

必需

Node.js 18+
从 nodejs.org 安装

必需

API 密钥
从控制台获取

免费

1
获取 CrawlForge API 密钥
下面的配置通过 npx 启动服务器，因此无需任何全局安装——只需要一个密钥。

在终端登录：CLI 会打开一个浏览器页面，你在其中批准一个新密钥，随后密钥会保存到 ~/.crawlforge/config.json。

Bash
npm install -g crawlforge-mcp-server
crawlforge login        # opens the browser approval page

或者从控制台复制一个密钥，在下一步粘贴到配置中。

2
配置 VS Code
选择你偏好的配置方式：

A方式 A：工作区 .vscode/mcp.json

在仓库根目录创建 .vscode/mcp.json。VS Code 使用 servers 键和 type 字段：

.vscode/mcp.jsonJson
{
  "servers": {
    "crawlforge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "crawlforge-mcp-server@latest",
        "mcp"
      ],
      "env": {
        "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here"
      }
    }
  }
}

如果你提交该文件，请不要把密钥写进去：VS Code 的 ${input:…} 变量会提示每位开发者输入自己的值。

B方式 B：用户配置文件

在命令面板（⇧⌘P / Ctrl+Shift+P）中运行 MCP: Open User Configuration，添加同样的 servers 条目，它将对所有工作区生效。MCP: Add Server 会引导你填写同样的字段。

3
设置你的 API 密钥
将 cf_live_your_api_key_here 替换为你的密钥，或让配置生成器为你填入。

限制工具列表（可选）

CrawlForge 提供 31 个工具。在同一个 env 块中设置 CRAWLFORGE_TOOL_GROUPS，即可只加载你需要的分组，例如 basic,search：

Json
"env": {
  "CRAWLFORGE_API_KEY": "cf_live_your_api_key_here",
  "CRAWLFORGE_TOOL_GROUPS": "basic,search"
}

分组：basic、search、crawl、extract、batch、research、tracking、llmstxt、stealth、templates、scrape、agent。

4
测试集成
以 Agent 模式打开 Copilot Chat，确认服务器正在运行。
  • 打开 Copilot Chat — 按 Ctrl+Alt+I（macOS 上为 ⌃⌘I），并把模式选择器切换到 Agent
  • 检查服务器 — 在命令面板中运行 MCP: List Servers；crawlforge 应显示为运行中
  • 测试提示 — 试试下面的某个示例；智能体会自行选择 CrawlForge 工具

示例提示

"搜索最新的 AI 资讯"

"从 example.com 提取所有链接"

"爬取文档站点并对其进行总结"

"从这个电商站点提取产品价格"

全部 31 个工具及其参数请参阅完整的 API 参考。

故障排查

服务器无法启动？

  1. 检查 .vscode/mcp.json 是否为有效 JSON
  2. 确认已安装 Node.js 18+：node --version
  3. 运行 MCP: List Servers，选择 crawlforge 并打开其输出查看错误
  4. 编辑文件后重新加载窗口

身份验证错误？

  1. 检查 API 密钥是否以 cf_live_ 开头
  2. 运行 crawlforge login 保存一个新密钥
  3. 从控制台生成新的 API 密钥

工具未出现在聊天中？

  1. 确认 Copilot Chat 处于 Agent 模式——Ask 模式不会调用工具
  2. 点击聊天输入框中的工具图标，启用 crawlforge 工具
  3. 完全重启 VS Code

集成成功了吗？

探索所有可用工具，或按照 Copilot 智能体模式的分步教程操作。

查看全部工具Copilot 智能体教程