groundlink-mcp
Groundlink MCP Server
Используйте цитируемые результаты веб-поиска Groundlink из любого хоста Model Context Protocol (MCP). Сервер предоставляет один узконаправленный инструмент groundlink_search, который отправляет запрос в Groundlink и возвращает результаты с источниками (title, url, snippet и source) для модели, когда ей нужны доказательства, а не догадки.
Groundlink в настоящее время объединяет результаты Wikipedia и DuckDuckGo. Каждый ключ API Groundlink включает 100 бесплатных тестовых запросов; после этого предоплаченное использование стоит $0,001 за запрос (один кредит за запрос).
Пакет:
groundlink-mcp@0.1.1опубликован на npm. Исходный код: https://github.com/ohhavefun/groundlink
Живая документация API: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
Цены и кредиты: https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing
Инструмент
Поле | Значение |
Имя инструмента |
|
Входные данные |
|
| 1–10; по умолчанию 5 (или |
Выходные данные | JSON: |
Используйте его для фактических вопросов, когда хост должен вернуть URL-адреса/источники вместе с ответом. MCP-сервер намеренно минималистичен: он пересылает запрос в HTTPS API Groundlink и возвращает ответ API через MCP stdio.
Related MCP server: websearch-mcp
Установка и запуск
Вам понадобится ключ API Groundlink (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-хосты должны запускать его, а не выполнять в интерактивном режиме.
Конфигурация
Переменная | Обязательная | По умолчанию | Описание |
| Да | — | Ключ API, используемый для каждого запроса Groundlink. |
| Нет | Живой URL Groundlink | Переопределяйте только для совместимого развертывания. |
| Нет |
| Количество результатов по умолчанию на вызов инструмента; максимум |
Конфигурация Claude Desktop
Добавьте эту запись в файл конфигурации MCP в Claude Desktop и перезапустите 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. Исходный код и смоук-тесты не входят в архив.
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