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

Инструмент

Используйте его для фактических вопросов, когда хост должен вернуть URL-адреса/источники вместе с ответом. MCP-сервер намеренно минималистичен: он пересылает запрос в HTTPS API Groundlink и возвращает ответ API через MCP stdio.

Related MCP server: DeepSearch 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-хосты должны запускать его, а не выполнять в интерактивном режиме.

Конфигурация

Конфигурация 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. Исходный код и смоук-тесты не входят в архив.