Skip to main content
Glama
ohhavefun

groundlink-mcp

by ohhavefun

使用 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

工具

字段

值

工具名称

groundlink_search

输入

{ query: string, max_results?: number }

max_results

1–10;默认 5(或 GROUNDLINK_MAX_RESULTS)

描述

对需要宿主在回答时返回 URL/来源的事实性问题使用此工具。该 MCP 服务器刻意保持轻量:它将查询转发到 Groundlink API,并通过 MCP stdio 返回 API 响应。

Related MCP server: google-search-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_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 指向已安装的 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 中。

Available Tools

1 tool

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.1.1
    • First observedgroundlink_search

TDQS

A4.4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of overlap or confusion between tools. The single search tool has a clearly defined purpose.

Naming Consistency5/5

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.

Tool Count3/5

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.

Completeness5/5

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

ActivitySlowing
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    C
    maintenance
    Enables web search and site-specific search capabilities through the Deepsearch model. Provides unified access to broad web retrieval and targeted site search functionality within the MCP ecosystem.
    2
    7 npm
    5
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to perform web searches with full content retrieval and multi-engine provenance, including trust scoring and local corpus persistence, via MCP integration.
    1 npm
    2
    Apache 2.0