Role1776/mcp-retrieval

これは何？

主な機能

• 01Web検索、画像検索、ページスクレイピングに対応する3つの読み取り専用ツール。
• 02検索とページコンテンツの取得に検索エンジンのAPIキーは不要。
• 03readability parserでページコンテンツを抽出し、Markdownで返す。
• 04ブラウザのTLSフィンガープリント偽装と、オプションのローテーションプロキシに対応。
• 05stdioとstreamable HTTPのトランスポートに対応。
• 06項目ごとにステータスを報告するため、一部で失敗しても成功した結果を返す。

ユースケース

• 検索APIに費用をかけず、ローカルLLMアシスタントに最新のWeb検索結果を提供する。
• Webページの記事本文を、整形されたMarkdownとしてモデルに渡す。
• IDEエージェントがコーディング中にドキュメントや最新情報を調べられるようにする。
• チーム向けの共有検索サーバーをHTTP経由で運用する。

クイックスタート

1. 1

   ソースからバイナリをビルドします（Go 1.25.5以降が必要です）

   make build
2. 2

   デフォルトのstdioトランスポートでサーバーを実行します

   ./bin/mcp-retrieval

使う前に知っておきたいこと

• !web_scrapeが扱うのはHTMLのみです。そのため、raw.githubusercontent.comなどのプレーンテキストやファイルのURLからは何も返されません。
• !画像検索の関連性は保証されないため、無関係な結果が含まれることがあり、確認が必要です。
• !ページはJavaScriptを実行せずに取得するため、クライアント側でレンダリングされるコンテンツは抽出されません。
• !並列検索が集中するとDuckDuckGoのボット判定が発動し、リクエスト頻度が下がるまで失敗することがあります。負荷を分散するにはプロキシが必要です。

収録されている特集

トピック

よくある質問

mcp-retrieval とは？

LLMクライアントにWeb検索、画像検索、ページのMarkdown化を提供する、APIキー不要のGo製MCPサーバー。 mcp-retrievalは、Goで書かれたModel Context Protocolサーバーです。Claude DesktopやIDEエージェントなど、MCP対応クライアントに読み取り専用ツールを3つ提供します。検索クエリ用のweb_search、画像検索用のweb_search_images、ページ本文をMarkdownとして抽出するweb_scrapeです。

mcp-retrieval は無料で使えますか？ライセンスは？

mcp-retrieval は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

mcp-retrieval は今もメンテナンスされていますか？

活発にメンテナンス中。mcp-retrieval の最終コミットは 2026年10月24日 です。

mcp-retrieval は何に使えますか？

検索APIに費用をかけず、ローカルLLMアシスタントに最新のWeb検索結果を提供する。 Webページの記事本文を、整形されたMarkdownとしてモデルに渡す。 IDEエージェントがコーディング中にドキュメントや最新情報を調べられるようにする。 チーム向けの共有検索サーバーをHTTP経由で運用する。

mcp-retrieval のインストール方法は？

ソースからバイナリをビルドします（Go 1.25.5以降が必要です）: make build デフォルトのstdioトランスポートでサーバーを実行します: ./bin/mcp-retrieval

mcp-retrieval はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Role1776/mcp-retrieval