Linkup MCP Server 使用说明

项目简介

Linkup MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它将 Linkup 强大的网页搜索功能通过标准化的 MCP 协议提供给支持函数调用的 LLM 客户端，例如 Claude。该服务器主要提供了一个 'search-web' 工具，允许 LLM 执行实时的网络搜索并获取搜索结果。

主要功能点

MCP 服务器: 遵循 Model Context Protocol 协议，作为 LLM 应用的后端，提供上下文服务。
工具注册与执行: 注册并提供 'search-web' 工具，LLM 可以调用此工具进行网页搜索。
联网搜索: 利用 Linkup SDK 实现网页搜索功能，为 LLM 提供最新的网络信息。
易于部署: 可以通过 'npx' 命令快速启动，方便集成到各种 LLM 工作流中。

安装步骤

由于该仓库发布在 npm 上，你可以通过 'npx' 命令直接运行，无需本地安装：

npx -y linkup-mcp-server --api-key=YOUR_LINKUP_API_KEY

或者，你也可以先设置环境变量 'LINKUP_API_KEY'，然后再运行：

export LINKUP_API_KEY=YOUR_LINKUP_API_KEY
npx -y linkup-mcp-server

如果你希望全局安装，可以使用 npm 安装：

npm install -g linkup-mcp-server

然后直接运行 'linkup-mcp-server' 命令 (同样需要配置 API Key)。

服务器配置

对于 MCP 客户端（例如 Claude），你需要配置 MCP 服务器的启动命令。以下是配置示例，你需要将这段 JSON 配置添加到你的 'claude_desktop_config.json' 文件中。

配置示例 (推荐使用环境变量方式):

{
  "mcpServers": {
    "linkup": {
      "command": "npx",
      "args": ["-y", "linkup-mcp-server"],
      "env": {
        "LINKUP_API_KEY": "YOUR_LINKUP_API_KEY"
      }
    }
  }
}

'server name': 'linkup' (服务器名称，可以自定义)
'command': 'npx' (启动命令，这里使用 npx)
'args': '["-y", "linkup-mcp-server"]' (传递给 npx 的参数，'-y' 表示自动确认安装，'linkup-mcp-server' 是要执行的包名)
'env': '{"LINKUP_API_KEY": "YOUR_LINKUP_API_KEY"}' (环境变量配置，请替换 'YOUR_LINKUP_API_KEY' 为你实际的 Linkup API Key)

配置示例 (直接在 args 中传递 API Key):

{
  "mcpServers": {
    "linkup": {
      "command": "npx",
      "args": ["-y", "linkup-mcp-server", "--api-key=YOUR_LINKUP_API_KEY"]
    }
  }
}

'server name': 'linkup' (服务器名称，可以自定义)
'command': 'npx' (启动命令，这里使用 npx)
'args': '["-y", "linkup-mcp-server", "--api-key=YOUR_LINKUP_API_KEY"]' (传递给 npx 的参数，'-y' 表示自动确认安装，'linkup-mcp-server' 是要执行的包名, '--api-key=YOUR_LINKUP_API_KEY' 请替换 'YOUR_LINKUP_API_KEY' 为你实际的 Linkup API Key)

注意: 你需要将 'YOUR_LINKUP_API_KEY' 替换为你从 Linkup 平台获得的 API Key。

基本使用方法

配置完成后，当你的 LLM 客户端（如 Claude）需要进行网页搜索时，它将能够调用 'search-web' 工具。

例如，在 Claude 中，你可以指示 Claude 使用 'search-web' 工具来搜索特定信息。Claude 会将你的搜索query传递给 Linkup MCP Server，服务器执行搜索并将结果返回给 Claude。

'search-web' 工具参数:

'query': (String, 必填) 你要搜索的关键词或短语。
'depth': (Enum: "standard" | "deep", 可选) 搜索深度，'standard' 为标准搜索，'deep' 为深度搜索（更耗时）。默认为 'standard'。

LLM 会根据你的指令和提供的参数调用 'search-web' 工具，并将搜索结果用于生成更准确和实时的回复。

关键词