Groundlink

Groundlink MCP 服务

在任何 Model Context Protocol (MCP) 宿主中使用 Groundlink 提供的带引用网页搜索结果。该服务提供一个专用工具 groundlink_search，用于向 Groundlink 发送查询，并返回包含来源的结果（title、url、snippet 和 source），供模型在需要证据而非猜测时使用。

Groundlink 目前整合了 Wikipedia 和 DuckDuckGo 的结果。每个 Groundlink API 密钥都包含 100 次免费测试查询；之后，预付费使用费用为 每次查询 $0.001（每次查询消耗 1 个额度）。

软件包： [email protected] 已发布到 npm。 源代码： https://github.com/ohhavefun/groundlink

• 在线 API 文档：https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
• 定价与额度：https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing

本仓库是 Groundlink 官方开发者集成的所在地。这里维护着两个集成：

集成	简介	安装
groundlink-mcp（MCP 服务）	让任何 MCP 宿主（Claude、Cursor、……）都能使用 Groundlink	npm install -g groundlink-mcp（也可在官方 MCP 注册表中找到，名称为 io.github.ohhavefun/groundlink）
langchain-groundlink（Python/LangChain）	为 Python Agent 提供 GroundlinkSearchTool	pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

两个集成都使用相同的 Groundlink 入门流程免费试用密钥（100 次查询），之后按每次查询 $0.001 预付费。

Groundlink 上架位置

---

langchain-groundlink（Python / LangChain）

在任何 Python Agent 或 BaseTool 工作流中使用 Groundlink 的带引用搜索。该工具会返回包含来源的结果（title、url、snippet、source），让你的 Agent 基于证据作答并引用来源。

从 GitHub 安装（此软件包不会发布到 PyPI）：

pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

快速使用（10 秒）： 从文档获取免费密钥，然后：

from langchain_groundlink import GroundlinkSearchTool

tool = GroundlinkSearchTool(api_key="glk_your_trial_key")  # or export GROUNDLINK_API_KEY
result = tool.invoke({"query": "Who was Ada Lovelace?"})
print(result)

完整用法、配置和错误处理说明请参见 langchain-groundlink/README.md。

---

Groundlink MCP 服务

在下方所列的任何 Model Context Protocol (MCP) 宿主中使用 Groundlink 提供的带引用网页搜索结果。

字段	值
工具名称	groundlink_search
输入	{ query: string, max_results?: number }
max_results	1–10；默认值为 5（或 GROUNDLINK_MAX_RESULTS）
输出	JSON：{ query, results: [{ title, url, snippet, source }], meta }

适用于需要宿主在回答中返回 URL 和来源的事实性问题。该 MCP 服务刻意保持轻量：它会将查询转发到 Groundlink HTTPS API，并通过 MCP stdio 返回 API 响应。

安装和运行

你需要一个 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 宿主应启动该进程，而不是以交互方式运行它。

配置

变量	必需	默认值	含义
GROUNDLINK_API_KEY	是	—	用于每次 Groundlink 请求的 API 密钥。
GROUNDLINK_BASE_URL	否	Groundlink 在线 URL	仅对兼容部署进行覆盖。
GROUNDLINK_MAX_RESULTS	否	5	每次工具调用的默认结果数，上限为 10。

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 指向已安装的 groundlink-mcp 二进制文件。

出错时会发生什么

• 缺少 GROUNDLINK_API_KEY：服务会在启动时退出，并显示清晰的配置错误。
• API 密钥被拒绝（401）：作为工具错误返回给 MCP 宿主；请更正密钥，而不要重试。
• 没有剩余的免费额度或预付额度（402）：作为工具错误返回；请先为密钥充值，再执行搜索。
• 搜索来源中断（502）：作为工具错误返回；短暂等待后重试或许有帮助。

市场描述

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 中。