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
工具
字段 | 值 |
工具名称 |
|
输入 |
|
| 1–10;默认 5(或 |
描述 | 对需要宿主在回答时返回 URL/来源的事实性问题使用此工具。该 MCP 服务器刻意保持轻量:它将查询转发到 Groundlink API,并通过 MCP stdio 返回 API 响应。 |
Related MCP server: websearch-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 主机应以启动方式运行,而不是交互式运行。
配置
参数 | 是否必填 | 默认值 | 说明 |
| 是 | — | 用于每次 Groundlink 请求的 API 密钥。 |
| 否 | Groundlink 实时地址 | 仅用于覆盖兼容部署的 URL。 |
| 否 |
| 每次工具调用的默认结果数;上限为 |
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 publishingnpm 包有意只随附编译后的 dist/ 运行时、本 README 和 npm 所需的元数据。源码和冒烟测试不包含在 tarball 中。
Available Tools
1 toolgroundlink_searchA
Search Groundlink's verified index (Wikipedia + DuckDuckGo) for a query and return cited results (title, url, snippet, source) so the model can answer with sources. Each call costs a fraction of a cent against the API key's free/credit balance. Prefer this over guessing when a factual claim needs verification or a source.
Inputs: query (required), max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of overlap or confusion between tools. The single search tool has a clearly defined purpose.
The tool name follows a clear and logical pattern: groundlink_search. Although there is only one tool, the naming is consistent with common conventions and leaves no ambiguity.
A single tool feels thin for a server, but it is focused on one specific search function that could be reasonably self-contained. It does not appear excessive, yet the surface is minimal.
For a search-focused server, the tool fully covers the core capability of searching and returning cited results. There are no obvious missing operations for its apparent purpose.
Maintenance
Related MCP Connectors
Live AI-native web search with citations. One tool for every MCP client. Flat per-request pricing.
Web search, scraping, RAG answers with citations, and translation as MCP tools.
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Google search, news, maps, webpages, cited answers, research and ChatGPT/Gemini answers for agents.
Related MCP Servers
- FlicenseAqualityDmaintenanceEnables MCP-compatible agents to perform web searches via the agent-web-search engine, returning ranked results with sources.1-
- AlicenseNot gradedqualityCmaintenanceEnables MCP-compatible AI applications to perform web searches via OpenAI's web search tool and receive concise factual results with source URLs, while leaving comparison and final reasoning to the calling AI.MIT
- FlicenseNot gradedqualityAmaintenanceEnables MCP clients to run real-time searches across Google, Bing, Yahoo, DuckDuckGo, YouTube, eBay, and other engines, with automatic formatting of answer boxes, organic results, news, images, shopping, weather, and stock data. Responses can be returned as structured JSON or token-efficient Markdown.-
- AlicenseCqualityBmaintenanceEnables existing AI assistants to search locally collected web evidence, retrieve cited results, exact quotes, revision IDs, and capture timestamps, and verify source listings through MCP.361MIT