LinkupPlatform-linkup-mcp-server

Linkup MCP 服务

一个模型上下文协议（MCP）服务，通过 Linkup 的 高级 API 提供网页搜索和页面抓取功能。此服务使 Claude 等 AI 助手能够使用自然语言查询执行智能网页搜索，并抓取任何网页的内容，从网络上可信来源获取实时信息。

功能

• 🔍 实时网页搜索：搜索网络，获取最新信息、新闻和数据
• 🧠 深度研究：启动耗时较长的多来源研究任务，并轮询获取结果
• 🌐 页面抓取：抓取并提取任何网页的内容
• 🎯 自然语言查询：使用完整的问题以获得最佳结果
• 📊 灵活的搜索深度：
  • standard - 适用于可直接回答的查询
  • deep - 适用于需要跨多个来源进行分析的复杂研究
• 🎯 结果筛选：按域名（includeDomains / excludeDomains）、日期范围（fromDate / toDate）和 maxResults 限制结果
• 🖼️ 图片结果：搜索可选用 includeImages，抓取可选用 extractImages
• 🖥️ JavaScript 渲染：可选启用 JS 渲染以处理动态内容
• 📄 原始 HTML：抓取时可选用 includeRawHtml，获取未经处理的页面
• ⚡ 快速：由 Linkup 的优化基础设施提供支持

安装

• Cursor、VSCode、Claude Code、Codex 或其他兼容 MCP 的客户端
• Linkup API 密钥

获取 API 密钥

1. 在 app.linkup.so 免费创建 Linkup 账户
2. 从控制面板复制 API 密钥

远程 MCP 服务（推荐）

托管的 Linkup MCP 服务使用 Streamable HTTP 传输。如果你的客户端支持远程 HTTP MCP 服务，可以直接引用托管端点。

如果你的客户端支持自定义 HTTP 标头，建议通过 Authorization: Bearer LINKUP_API_KEY 发送 API 密钥，而不是将其放在 URL 中。对于无法发送自定义标头的客户端，仍支持 ?apiKey=... 查询参数。

Cursor

在 ~/.cursor/mcp.json 文件中添加以下内容：

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "type": "http",
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
    }
  }
}

VSCode

将以下内容添加到 VS Code MCP 配置文件中。更多信息请参阅 VS Code MCP 文档。

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "url": "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY",
      "type": "http"
    }
  }
}

Codex

Codex 通过 config.toml 同时支持远程 HTTP MCP 服务和自定义 HTTP 标头。

使用来自环境变量的 bearer token：

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp"
bearer_token_env_var = "LINKUP_API_KEY"
enabled = true

或者，如果你希望继续使用查询参数：

[mcp_servers.linkup]
url = "https://mcp.linkup.so/mcp?apiKey=LINKUP_API_KEY"
enabled = true

MCP Bundle（推荐用于 Claude Desktop）

下载预构建的 MCP Bundle，这是一个可在 Claude Desktop 等兼容 MCP 客户端中使用的独立软件包。MCP Bundles 由 Anthropic 开发。更多信息请参阅 MCP Bundles 仓库。

快速下载：

curl -L -o linkup-mcp-server.mcpb https://github.com/LinkupPlatform/linkup-mcp-server/releases/latest/download/linkup-mcp-server.mcpb

安装：

1. 从 releases 下载 linkup-mcp-server.mcpb（或使用上方的 curl 命令）
2. 点击该文件进行安装
3. 根据提示配置 API 密钥

本地 MCP 服务

你也可以通过 stdio 传输在本地运行 MCP 服务。

Cursor

{
  "mcpServers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

VSCode

{
  "servers": {
    // ... other MCP servers
    "linkup": {
      "command": "npx",
      "type": "stdio",
      "args": [
        "-y",
        "linkup-mcp-server",
        "apiKey=LINKUP_API_KEY"
      ]
    }
  }
}

Codex

[mcp_servers.linkup]
command = "npx"
args = ["-y", "linkup-mcp-server", "apiKey=LINKUP_API_KEY"]
enabled = true

用法

配置完成后，你可以让 AI Agent 搜索网页或获取网页内容：

搜索示例：

• “搜索网络，了解 AI 发展方面的最新消息”
• “东京现在的天气怎么样？”
• “查找有关新的《欧盟 AI 法案》及其对初创企业影响的信息”
• “搜索 NVIDIA 的最新股价”

研究示例：

• “比较 Microsoft、Amazon 和 Google 在 2024 年的云业务收入增长。”

研究是一项耗时较长的操作（通常需要几分钟）。Agent 会先使用 linkup-research 启动任务，然后使用返回的任务 id 轮询 linkup-get-research，直到状态为 completed 或 failed。

获取示例：

• “获取 https://example.com/article 的内容”
• “获取这篇博客文章的内容：https://blog.example.com/post，并为其撰写摘要”
• “启用 JavaScript 渲染，获取 https://example.com 的内容”

搜索深度

• 标准搜索：最适合有直接答案的查询（天气、股价、简单事实）
• 深度搜索：最适合需要跨多个来源进行分析的复杂研究（综合指南、对比分析、深入研究）

可用工具

linkup-search

使用 Linkup 实时搜索网络，从可信来源获取最新信息、事实和新闻。

参数：

• query（必填）：自然语言搜索查询。完整的问题效果最佳。
• depth（可选）：搜索深度——"standard"（默认）或 "deep"。
• includeImages（可选，默认 false）：在文本结果旁返回相关图片，每张图片都包含 URL 和元数据。
• includeDomains（可选）：用于限制结果范围的域名数组，例如 ["bbc.com", "reuters.com"]。最多 100 个域名。
• excludeDomains（可选）：用于排除结果的域名数组，例如 ["reddit.com", "quora.com"]。
• fromDate（可选）：仅包含在此日期或之后发布的内容。格式为 YYYY-MM-DD。
• toDate（可选）：仅包含在此日期或之前发布的内容。格式为 YYYY-MM-DD。
• maxResults（可选）：要返回的最大结果数（正整数）。

使用场景：

• 实时数据（天气、股票、体育赛事比分、活动）
• 突发新闻和时事
• 最新研究和出版物
• 产品信息和最新价格
• 日程安排和可用情况
• AI 知识库中没有的任何信息

linkup-research

提交一项自主 Linkup 研究任务：Agent 会调查网络，回答单次搜索查询无法解决的问题，并返回综合整理且附有引用的答案。适用于获取经过验证的精确问题答案、针对明确主题进行重点调查，或生成涵盖多个角度的广泛报告。此操作为异步且耗时较长（可能需要几分钟）：它会立即返回任务 id 和 status，而非最终结果。使用 linkup-get-research 轮询任务是否完成。

参数：

• query（必需）：自然语言研究问题。详细完整的问题效果最佳。
• mode（可选）：控制调查类型。使用 "answer" 获取精确且有证据支持的答案，使用 "investigate" 针对一个主题生成重点报告，或使用 "research" 生成涵盖多个主题的结构化报告。省略此项则由 Linkup 判断问题类型。
• reasoningDepth（可选）：控制任务投入的推理力度，在响应延迟和覆盖范围之间权衡。使用 "S" 表示轻度覆盖，"M" 表示均衡，"L"（默认值）表示深入，或使用 "XL" 表示全面。
• includeDomains（可选）：用于限制结果来源的域名数组，例如 ["bbc.com", "reuters.com"]。建议设置；最多 100 个域名。
• excludeDomains（可选）：要从结果中排除的域名数组，例如 ["reddit.com", "quora.com"]。
• fromDate（可选）：仅包含在此日期或之后发布的内容。格式为 YYYY-MM-DD。
• toDate（可选）：仅包含在此日期或之前发布的内容。格式为 YYYY-MM-DD。

适用场景：

• 全面的研究报告和比较分析
• 需要综合多个来源的调查
• 快速搜索无法充分解答的复杂问题

linkup-get-research

获取由 linkup-research 启动的研究任务的当前状态。

参数：

• id（必需）：由 linkup-research 返回的研究任务 ID。

行为：

• 返回包含任务 status（pending、processing、completed、failed）的任务对象。
• 当状态为 pending/processing 时，每隔几秒继续轮询，直到任务进入终止状态；轮询频率快于每秒一次会受到速率限制。
• 状态为 completed 时，结果位于 output 字段中；状态为 failed 时，原因位于 error 字段中。

linkup-fetch

从任意网页 URL 获取并提取内容。

参数：

• url（必需）：要获取内容的 URL。
• renderJs（可选，默认值为 false）：是否渲染 JavaScript 内容。对于通过 JavaScript 加载内容的动态页面，请启用此项。注意：这会使请求变慢。
• extractImages（可选，默认值为 false）：提取页面中的图片，并在专用的 images 字段中返回。当你需要获取所有图片列表以便进一步处理或分析时，此项很有用。
• includeRawHtml（可选，默认值为 false）：在专用的 rawHtml 字段中包含页面的原始 HTML。当你需要自定义 HTML 解析、保留特定格式，或访问标准内容提取过程中可能被过滤的元素时，此项很有用。

适用场景：

• 获取页面内容以进行分析或总结
• 提取新闻网站中的文章内容
• 获取技术网站上的文档
• 获取博客文章和文字内容

开发

先决条件

• Node.js >= 24.0.0
• npm

设置

# Install dependencies
npm install

运行 HTTP 服务

npm run dev

这会在 http://localhost:2121/mcp 启动本地 Streamable HTTP 服务。

使用 stdio 传输方式运行

npm run build:stdio
npm run start:stdio -- apiKey=YOUR_API_KEY

在本地开发时，也可以通过环境变量传递密钥：

LINKUP_API_KEY=YOUR_API_KEY npm run start:stdio

使用 MCP Inspector 测试

npm run build:stdio
npm run inspector -- apiKey=YOUR_API_KEY

这会在浏览器中打开 MCP Inspector，你可以在其中交互式测试搜索工具。

许可证

MIT

链接

• Linkup 网站
• Linkup 文档
• 模型上下文协议

支持

如果您遇到问题，请发送邮件至 [email protected] 联系我们，或加入我们的 Discord 服务。