Piのコーディングエージェントが1つのプロキシツール経由でMCPサーバーを使えるようにし、未使用のツール定義でコンテキストウィンドウが埋まるのを防ぐアダプターです。
ref-tools/ref-tools-mcp
AIコーディングエージェントが、公開・非公開のライブラリドキュメントをトークン効率よく参照できるMCPサーバー。
- スター
- 1,184
- フォーク
- 72
- 未解決の Issue
- 12
- 最終コミット
- 23 時間前
これは何?
Ref MCPは、AIコーディングツールやエージェントがAPI、サービス、ライブラリのドキュメントを検索・閲覧できるModel Context Protocolサーバーです。全文形式のクエリを受け取り、公開Webページ、GitHub、リポジトリやPDFなどの非公開リソースから関連する検索結果を返す検索ツールと、URLの内容を取得してMarkdownに変換する読み取りツールを提供します。
エージェントのコンテキストウィンドウを小さく保つことを重視しています。MCPセッション内で過去の検索を追跡するため、同じクエリを繰り返しても同じ結果は返しません。また、長いページを読み取る際は、検索履歴をもとに関連性の低いセクションを省き、ページ全体ではなく、関連性の高い約5kトークン分を返します。
サーバーへの接続には、プロジェクトが推奨するホスト型のstreamable-httpエンドポイントを使う方法と、npx経由でローカルのstdio上で実行する方法があります。また、OpenAI deep researchクライアントと互換性のあるツール名も提供します。
主な機能
- 01単一の検索ツールで、公開Web、GitHub、非公開のドキュメントソースを検索できます。
- 02同じセッション内で先に返した検索結果を除外し、重複を防ぎます。
- 03URLをMarkdownに変換し、関連性の高いセクションに絞り込みます。
- 04streamable-httpとローカルstdioの両方で接続できます。
- 05OpenAI deep researchと互換性のあるツール名を提供します。
ユースケース
- 連携コードの作成中に、コーディングエージェントが最新のAPIエンドポイントを調べる。
- エージェントから、社内向けの非公開ライブラリドキュメントやリポジトリを参照できるようにする。
- エージェントが長いドキュメントページを読む際のトークンコストとノイズを減らす。
クイックスタート
- 1
ref.tools に登録して API キーを取得します
- 2
stdio サーバーを MCP クライアントの設定に追加し、REF_API_KEY を設定して npx で実行します
npx ref-tools-mcp@latest
使う前に知っておきたいこと
- ref.tools への登録で取得できる Ref API キーが必要です。
- このリポジトリにはレガシー版の stdio サーバーが含まれています。README では、代わりにホスト型の streamable-http サーバーを推奨しています。
収録されている特集
トピック
よくある質問
- ref-tools-mcp とは?
- AIコーディングエージェントが、公開・非公開のライブラリドキュメントをトークン効率よく参照できるMCPサーバー。 Ref MCPは、AIコーディングツールやエージェントがAPI、サービス、ライブラリのドキュメントを検索・閲覧できるModel Context Protocolサーバーです。全文形式のクエリを受け取り、公開Webページ、GitHub、リポジトリやPDFなどの非公開リソースから関連する検索結果を返す検索ツールと、URLの内容を取得してMarkdownに変換する読み取りツールを提供します。
- ref-tools-mcp は無料で使えますか?ライセンスは?
- ref-tools-mcp は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- ref-tools-mcp は今もメンテナンスされていますか?
- 活発にメンテナンス中。ref-tools-mcp の最終コミットは 2026年11月6日 です。
- ref-tools-mcp は何に使えますか?
- 連携コードの作成中に、コーディングエージェントが最新のAPIエンドポイントを調べる。 エージェントから、社内向けの非公開ライブラリドキュメントやリポジトリを参照できるようにする。 エージェントが長いドキュメントページを読む際のトークンコストとノイズを減らす。
- ref-tools-mcp のインストール方法は?
- ref.tools に登録して API キーを取得します stdio サーバーを MCP クライアントの設定に追加し、REF_API_KEY を設定して npx で実行します: npx ref-tools-mcp@latest
- ref-tools-mcp はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/ref-tools/ref-tools-mcp
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIコーディングエージェントに、最新かつバージョンに合ったライブラリのドキュメントとコード例を提供するMCPサーバー兼CLI。
多くの開発者向けリファレンスドキュメントを、検索やオフライン利用に対応したWebインターフェースに集約するAPIドキュメントブラウザー。
Cursor、VS Code、Windsurf、Claude Desktopからのプロンプトを各種AIモデルに振り分けるローカルMCPサーバー
コードベースの内容を根拠に、コーディングエージェントや開発者向けの、相互リンクされたMarkdown Wikiを作成・保守するCLI。
LLMに渡す前にツール出力、ログ、ファイル、RAGチャンクを圧縮するライブラリ、プロキシ、MCPサーバー。