Groundlink

Groundlink MCP サーバー

任意の Model Context Protocol（MCP）ホストから、Groundlink の出典付きウェブ検索結果を利用できます。このサーバーは、Groundlink にクエリを送信し、モデルが推測ではなく根拠を必要とするときに利用できる、出典情報を含む結果（title、url、snippet、source）を返す、専用のツール groundlink_search を公開します。

Groundlink は現在、Wikipedia と DuckDuckGo の検索結果を組み合わせています。Groundlink の各 API キーにはテスト用の無料クエリが 100 件含まれています。無料分を使い切った後は、前払い方式でクエリ 1 件あたり $0.001です（1 クエリにつき 1 クレジット）。

パッケージ： [email protected] が npm で公開されています。 ソース： https://github.com/ohhavefun/groundlink

• API ドキュメント： https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/docs
• 料金とクレジット： https://9ea69cec60fa01f65bbb647a092bcbb4.ctonew.app/pricing

このリポジトリは、Groundlink の公式開発者向けインテグレーションのホームです。インテグレーションは 2 つあり、どちらもこのリポジトリでメンテナンスされています。

インテグレーション	内容	インストール
groundlink-mcp（MCP サーバー）	Groundlink を任意の MCP ホスト（Claude、Cursor、…）に公開します	npm install -g groundlink-mcp（公式 MCP レジストリにも io.github.ohhavefun/groundlink として登録されています：https://registry.modelcontextprotocol.io）
langchain-groundlink（Python/LangChain）	Python エージェント向けの GroundlinkSearchTool です	pip install "langchain-groundlink @ git+https://github.com/ohhavefun/groundlink#subdirectory=langchain-groundlink"

どちらも Groundlink のオンボーディングで取得できる同じ無料トライアルキー（100 クエリ）を使用し、その後はクエリ 1 件あたり $0.001 の前払い方式で利用できます。

Groundlink の掲載先

---

langchain-groundlink（Python / LangChain）

任意の Python エージェント、または BaseTool パイプラインから、Groundlink の出典付き検索を利用できます。このツールは出典情報を含む結果（title、url、snippet、source）を返すため、エージェントは根拠に基づいて回答し、その出典を引用できます。

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 に転送し、API のレスポンスを MCP の**標準入出力（stdio）**経由で返します。

インストールと実行

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

プロセスは標準入出力を使用します。HTTP ポートを開いたり、通常の出力を標準出力に書き込んだりすることはありません。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 に含まれません。