/ ディレクトリ / プレイグラウンド / ref-tools-mcp
● コミュニティ ref-tools ⚡ 即起動

ref-tools-mcp

作者 ref-tools · ref-tools/ref-tools-mcp

コーディングエージェントが適切なドキュメントを素早く見つけるのを支援します。公開ライブラリ、プライベートリポジトリ、社内PDFを対象とし、不要なページでコンテキストを浪費しません。

ref-tools/ref-tools-mcp(Ref提供)は2つのツールを提供します。公開Webサイト、GitHubリポジトリ、プライベートリソースを対象にした絞り込み型のドキュメント検索と、Markdownを返すURL読み取り機能です。REF_API_KEYが必要です。

なぜ使うのか

主な機能

ライブデモ

実際の動作

ref-tools.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "ref-tools": {
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "ref-tools",
      "command": "npx",
      "args": [
        "-y",
        "ref-tools-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "ref-tools": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "ref-tools-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add ref-tools -- npx -y ref-tools-mcp

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: ref-tools-mcp

エージェントがライブラリAPIを幻想するのを防ぐ方法

👤 コーディングエージェントユーザー ⏱ ~10 min beginner

使うタイミング: エージェントが現在のライブラリバージョンと一致しないコードを自信を持って作成する場合

前提条件
  • Refアカウント + REF_API_KEY — ref.toolsでサインアップしてください(またはRef現在のサインアップURLを使用)
フロー
  1. ドキュメントに基づいた質問をする
    ref_search_documentationを使用してPrisma v5でraw SQLクエリを使用する方法を見つけて、例を書いてください。✓ コピーしました
    → 検索結果がURLと共に表示されます。コードがそれらを引用します
  2. 検証する
    トップの検索結果でref_read_urlを使用してAPI形状を確認してください。✓ コピーしました
    → ドキュメントページのクリーンなMarkdown

結果: 実際のライブラリバージョンに対してコンパイルされるコード

注意点
  • 検索結果として廃止予定のv-Xの古いドキュメントが返される — クエリにバージョンを含める: 'Prisma v5 raw SQL'
組み合わせ: github

エージェントで社内エンジニアリングドキュメント/PDFを検索する方法

👤 社内ランブックを持つプラットフォームチーム ⏱ ~15 min intermediate

使うタイミング: エージェントがStackOverflowではなく会社固有のパターンに従う必要がある場合

前提条件
  • Refプライベートソースがインデックス済み — リポジトリ/PDFをRefワークスペースにアップロードしてください(Refドキュメント参照)
フロー
  1. 検索をプライベートに限定する
    ref_search_documentationで'internal auth pattern'をプライベートソースのみを対象に検索してください。✓ コピーしました
    → 社内結果のみが表示される
  2. ランブックを読む
    トップの社内結果でref_read_urlを使用してください。✓ コピーしました
    → ランブックのクリーンなテキスト

結果: 社内標準準拠の出力

注意点
  • 社内ドキュメントが古くなっているが、エージェントはまだそれらを引用している — エージェントに「最終更新日」メタデータをチェックして、古いコンテンツにフラグを立てるよう指示してください

任意のURLをクリーンなMarkdownとして取得する方法

👤 研究と要約を行う人 ⏱ ~5 min beginner

使うタイミング: ナビゲーション、広告、JavaScriptなど余分な要素を除いた記事本文が必要な場合

フロー
  1. URLを読む
    ref_read_url https://some-blog.com/post — クリーンなMarkdownを提供してください。✓ コピーしました
    → Markdownとしてのボディテキスト
  2. 要約する
    5つの箇条書きで要約を提供してください。✓ コピーしました
    → 要約

結果: クリーンなコンテンツ、高速に取得できます

組み合わせ: markdownify

組み合わせ

他のMCPと組み合わせて10倍の力を

ref-tools + github

公式ドキュメント引用をもつPRレビューに基づかせる

PR #1234のPrismaマイグレーションについて、ref_search_documentationを使用して各APIがv5ドキュメントと一致することを確認してから、PRにコメントしてください。✓ コピーしました
ref-tools + markdownify

RefでインデックスされていないローカルPDFについて、Refのドキュメント検索とmarkdownifyを組み合わせる

Refで社内認証ガイダンスを検索してから、まだインデックスされていない追加の/specs/auth-v3.pdfをmarkdownifyしてください。✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
ref_search_documentation query: str, sources?: str[] ライブラリまたは社内ドキュメントの質問に基づかせる場合 1 Ref API call
ref_read_url url: str ページをクリーンなMarkdownとして取得する場合 1 Ref API call

コストと制限

運用コスト

APIクォータ
Refプランレベルごと
呼び出しあたりのトークン
検索結果: 500-2000トークン。URL読み取り: 5k-20kになる可能性があります
金額
Refは有料サービス(無料ティアあり)です。最新の価格を確認してください
ヒント
最初に検索して、トップの結果だけを読んでください。連続読み取りは高価です。

セキュリティ

権限、シークレット、影響範囲

最小スコープ: REF_API_KEYを環境変数に保存する
認証情報の保管: REF_API_KEY環境変数
データ送信先: クエリはRefサービスに送信されます。それはその後、公開Webとインデックスされたプライベートソースにアクセスします
絶対に付与しない: ワークスペースキーを広く共有しないでください。Refがサポートしている場合は、ユーザーごとのキーを使用してください。

トラブルシューティング

よくあるエラーと対処法

401 Unauthorized

REF_API_KEYが不足しているか、無効です。

確認: echo $REF_API_KEY
検索結果が古い結果を返す

プライベートソースの再インデックスが遅延する可能性があります。Refダッシュボードから再インデックスを強制してください。

ref_read_urlが空を返す

一部のサイトはスクレイピングをブロックします。フォールバックとしてmarkdownify経由でwebpage-to-markdownを使用してください。

クォータ超過

Refプランをアップグレードするか、検索使用量を分散してください。

代替案

ref-tools-mcp 他との比較

代替案代わりに使う場面トレードオフ
Context7 MCP無料の公開ライブラリドキュメント取得が必要な場合プライベートソースのインデックスはありません
Apple Docs MCP / pg-aiguide特定のプラットフォームのドキュメントだけに関心がある場合スコープが限定されています。汎用ではありません。

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る