groundlink-mcp

Groundlink MCP 服务器

使用 Groundlink 的引用网络搜索结果，来自任何模型上下文协议（MCP）主机。该服务器提供一个聚焦的工具 groundlink_search，它向 Groundlink 发送查询，并返回带来源的结果（title、url、snippet、source），供模型在需要证据而非猜测时使用。

Groundlink 目前结合了 Wikipedia 与 DuckDuckGo 的结果。每个 Groundlink API 密钥包含 100 次免费测试查询；之后，预付费使用价格为 每次查询 $0.001（每次查询一个积分）。

包: groundlink-mcp@0.1.1 已发布在 npm 上。 来源： https://github.com/ohhavefun/groundlink

• 实时 API 文档： https://9ea69cec60f01f65feb647a092bcbb4.ctonew.app/docs

• 定价与积分： https://9ea69cec60f01f65feb647a092bcbb4.ctonew.app/pricing

工具

Related MCP server: DeepSearch MCP

安装与运行

你需要一个 Groundlink API 密钥（glk_...）。向 Groundlink 运营商索取一个，或通过 Groundlink 的入门流程获取一个。

npm install -g groundlink-mcp
export GROUNDLINK_API_KEY=glk_your_key_here
groundlink-mcp

或者，MCP 主机可以在不进行全局安装的情况下执行该包：

npx -y groundlink-mcp

该进程使用 stdio；它不会打开 HTTP 端口，也不会向 stdout 打印正常输出。MCP 主机应以启动方式运行，而不是交互式运行。

配置

Claude Desktop 配置

将此条目添加到 Claude Desktop 的 MCP 配置文件中，然后重启 Claude Desktop。请妥善保管 API 密钥：不要将其提交到代码仓库或共享该配置文件。

{
  "mcpServers": {
    "groundlink": {
      "command": "npx",
      "args": ["-y", "groundlink-mcp"],
      "env": {
        "GROUNDLINK_API_KEY": "glk_your_key_here"
      }
    }
  }
}

如果此包已全局安装，请使用 "command": "groundlink-mcp" 并省略 args。对于需要绝对可执行文件路径的主机，请将 command 指向已安装的 bunt groundlink` 可执行文件。

错误处理

• 缺少 GROUNDLINK_API_KEY：服务器在启动时因错误退出。该配置错误。

• API 密钥被拒绝（401）：作为工具错误返回给 MCP 主机；请更正密钥，而不是重试。

• 没有剩余免费或预付费积分（402）：作为工具错误返回；请在下一次搜索之前为该密钥充值。

Marketplace 描述

Groundlink — 为 MCP 提供引用的网络搜索。 为 Claude、Cursor 及其他 MCP 主机提供一个 groundlink_search 工具，该工具返回带引用的结果，而不是无引用的事实猜测。每个密钥都有 100 次免费查询，之后通过预付费积分按 $0.001 每次查询计费。

开发与发布检查

bun install
bun run typecheck
bun run build             # emits executable dist/index.js
bun run test              # MCP stdio smoke test
npm run pack:check        # inspect the npm tarball without publishing

npm 包有意只随附编译后的 dist/ 运行时、本 README 和 npm 所需的元数据。源码和冒烟测试不包含在 tarball 中。