Ragmap

RAGMap（RAG MCP レジストリファインダー）

お試しください： https://ragmap-api.web.app/browse/ まずはこちら： https://github.com/khalidsaidi/ragmap/discussions/17

RAGMap は、RAG 関連の MCP サーバーに特化した、軽量で MCP Registry 互換のサブレジストリ兼 MCP サーバーです。

以下の機能を提供します。

• 公式 MCP Registry を取り込み、RAG のユースケース向けにレコードを拡充して、サブレジストリ API として提供します。
• エージェントが RAG MCP サーバーを検索・絞り込みできるように、MCP サーバー（リモートの Streamable HTTP ＋ ローカルの stdio）を公開します。

MapRag（RAGMap）

MapRag は、検索のためのディスカバリー＋ルーティングレイヤーです。 エージェントや人が、「制約を踏まえると、このタスクにはどの検索 MCP サーバーを使えばよいか？」という問いに答えるのを支援します。

RAGMap 自体は検索を行いません。検索機能を備えたサーバーをインデックス化して情報を拡充し、適切なツール／サーバーへ案内します。

インストール後にできること（平易な説明）

• ディスカバリー／ルーティングツール（rag_find_servers、rag_get_server、rag_list_categories、rag_explain_score）を利用できます。
• RAGMap は、タスクと制約に最適な検索サーバーを見つけるのに役立ちます。
• その後、エージェントは選択したサーバーに接続し、実際の検索を行います。

RAGMap は、以下の機能を提供しません。

• プライベートなドキュメントを自動的に取り込むこと。
• 個人用のベクトルデータベースをホストすること。
• エンドツーエンドの RAG パイプラインを置き換えること。

独自のデータを検索する必要がある場合は、RAGMap の検索結果にある検索サーバー（または独自のサーバー）のうち、データ取り込み／インデックス作成のフローに対応したものを使用してください。

データの鮮度と取り込み

• ホスト版 RAGMap は、スケジュールに従ってインデックスを更新します。新たに公開または変更されたサーバーが反映されるまで、時間がかかる場合があります。
• ホスト版サービスを使用する場合、ほとんどのユーザーは自分でデータを取り込む必要はありません。
• データの鮮度をより厳密に管理する場合や、プライベートなインデックス作成が必要な場合は、セルフホストして独自の取り込みスケジュールを設定してください（docs/DEPLOYMENT.md）。

機能： レジストリ互換 API、セマンティック検索＋キーワード検索（OPENAI_API_KEY が設定されている場合。例：環境変数またはデプロイ先のシークレットマネージャーから設定）、カテゴリと ragScore、hasRemote、reachable（streamable-http／SSE を対象としたプローブチェック）、citations、localOnly、transport、minScore、categories による絞り込み。ragmap-api.web.app/browse で人間向けの閲覧 UIを提供し、検索、絞り込み、Cursor／Claude の設定のコピーができます。MCP ツール：rag_find_servers、rag_get_server、rag_list_categories、rag_explain_score。

クイックスタート

必要なもの：curl と jq

1) 到達可能な検索サーバーの上位一覧（24 時間以内にチェック済み）

curl -s "https://ragmap-api.web.app/rag/top?hasRemote=true&reachable=true&reachableMaxAgeHours=24&serverKind=retriever&limit=25" | jq .

2) 信頼性フィルターを使った検索（最近到達可能と確認済み）

curl -s "https://ragmap-api.web.app/rag/search?q=rag&hasRemote=true&reachable=true&reachableMaxAgeHours=24&limit=10" | jq .

3) サーバーのインストール設定を取得

ヒント：/ を含む名前は URL エンコードしてください。

curl -s "https://ragmap-api.web.app/rag/install?name=ai.filegraph%2Fdocument-processing" | jq .

4) データの鮮度と網羅状況を確認

curl -s "https://ragmap-api.web.app/rag/stats" | jq .

5) 利用状況テレメトリーの概要

curl -s "https://ragmap-api.web.app/api/stats" | jq .

全体の概要：docs/OVERVIEW.md
リリース履歴：CHANGELOG.md

アーキテクチャ

%%{init: {"theme":"base","themeVariables":{"primaryColor":"#ffffff","primaryTextColor":"#000000","primaryBorderColor":"#000000","lineColor":"#000000","secondaryColor":"#ffffff","tertiaryColor":"#ffffff","clusterBkg":"#ffffff","clusterBorder":"#000000","edgeLabelBackground":"#ffffff"},"flowchart":{"curve":"linear","nodeSpacing":75,"rankSpacing":70}}}%%
flowchart TB
  %% Concept-only diagram (product value; no deployment/framework/datastore details)

  classDef mono fill:#ffffff,stroke:#000000,color:#000000,stroke-width:1px;

  subgraph Inputs[" "]
    direction LR

    subgraph Query["Agent-native interface"]
      direction TB
      Users["Agents + humans"]:::mono
      subgraph Tooling["Tool call"]
        direction LR
        Criteria["Routing constraints<br/>domain, privacy, citations,<br/>freshness, auth, limits"]:::mono
        Tools["MCP tools<br/>rag_find_servers<br/>rag_get_server<br/>rag_list_categories<br/>rag_explain_score"]:::mono
      end
      Users --> Criteria --> Tools
    end

    subgraph Subregistry["Subregistry (read-only)"]
      direction TB
      subgraph Ingest["Ingest"]
        direction LR
        Sources["Upstream MCP registries<br/>(official + optional)"]:::mono
        Sync["Sync + normalize<br/>(stable schema)"]:::mono
        Catalog["Enriched catalog<br/>(servers + versions)"]:::mono
        Sources --> Sync --> Catalog
      end

      subgraph Enrich["Enrich (adds value)"]
        direction LR
        Cap["Structured metadata<br/>domain: docs|code|web|mixed<br/>retrieval: dense|sparse|hybrid (+rerank)<br/>freshness: static|continuous (max lag)<br/>grounding: citations|provenance<br/>privacy/auth: local|remote + req|optional<br/>limits: top_k|rate|max ctx"]:::mono
        Trust["Trust signals (lightweight)<br/>status, reachability,<br/>schema stability, reports"]:::mono
      end

      Catalog --> Cap
      Catalog --> Trust
    end
  end

  subgraph Selection["Selection (the added value)"]
    direction LR
    Router["Router<br/>match + rank + explain"]:::mono
    Ranked["Ranked candidates<br/>+ reasons + connect info"]:::mono
    Retrieval["Chosen retrieval MCP server(s)<br/>(do retrieval)"]:::mono
    Router --> Ranked --> Retrieval
  end

  Tools --> Router
  Catalog --> Router

  %% Keep the layout without adding a third visible "box" around Inputs.
  style Inputs fill:#ffffff,stroke:#ffffff,stroke-width:0px

モノレポの構成

• apps/api：REST API ＋ MCP レジストリ互換エンドポイント ＋ 取り込みワーカー
• apps/mcp-remote：リモート MCP サーバー（Streamable HTTP）
• packages/mcp-local：ローカル MCP サーバー（stdio）
• packages/shared：Zod スキーマ ＋ 共通型
• docs：ドキュメント ＋ Firebase Hosting の静的アセット

ローカル開発

cp .env.example .env
corepack enable
pnpm -r install
pnpm -r dev

任意：ローカルでセマンティック検索を有効にするには、.env に OPENAI_API_KEY を設定します（.env.example を参照）。GET /health に "embeddings": true と表示されます。

API：http://localhost:3000 MCP リモート：http://localhost:4000/mcp

取り込み

curl -X POST http://localhost:3000/internal/ingest/run \
  -H "Content-Type: application/json" \
  -H "X-Ingest-Token: $INGEST_TOKEN" \
  -d '{"mode":"full"}'

MCP の使用方法

リモート（Streamable HTTP）：

claude mcp add --transport http ragmap https://<your-mcp-domain>/mcp

ローカル（stdio、npm）：

npx -y @khalidsaidi/ragmap-mcp@latest

ローカル（stdio）：

pnpm -C packages/mcp-local dev

主なエンドポイント

• GET /embed — 埋め込み可能な「Search RAG MCP servers」ウィジェット（iframe。クエリパラメーター：q、limit）
• GET /health（セマンティック検索の有効／無効に応じて embeddings: true|false を含みます）
• GET /readyz
• GET /v0.1/servers
• GET /v0.1/servers/:serverName/versions
• GET /v0.1/servers/:serverName/versions/:version（latest をサポート）
• GET /rag/search
• GET /rag/top（デフォルトの並べ替え済みおすすめ。limit の上限は 50）
• GET /rag/install
• GET /rag/stats
• GET /rag/categories
• GET /api/stats（公開利用状況の集計。PII は含みません）
• GET /api/usage-graph（利用状況の HTML チャート）
• POST /internal/ingest/run（保護されています）

ホスト版の ragmap-api.web.app では、/internal/* ルートは公開されません。

GET /rag/search のクエリパラメーター：

• q（文字列）
• categories（カンマ区切り）
• minScore（0〜100）
• transport（stdio または streamable-http）
• registryType（文字列）
• hasRemote（true または false — リモートエンドポイントを持つサーバーのみ）
• reachable（true — streamable-http/SSE 経由で到達可能であることが最近のプローブチェックで確認されたサーバーのみ）
• reachableMaxAgeHours（任意。reachable=true の場合のみ使用 — N 時間以内にチェックされた結果のみを保持）
• citations（true — メタデータで引用／グラウンディングに言及しているサーバーのみ）
• localOnly（true — stdio のみ。リモートは含みません）

スモークテスト

API_BASE_URL=https://ragmap-api.web.app ./scripts/smoke-public.sh
MCP_URL=https://ragmap-api.web.app/mcp ./scripts/smoke-mcp.sh

ドキュメント

• docs/DISCOVERY-LINK-CONVENTION.md — クライアントが「Discover more」を表示できるようにする、server.json の任意項目 discoveryService
• docs/AGENT-USAGE.md — エージェント向け： 検出、REST API、MCP のインストール（人間の介入なし）
• docs/DEPLOYMENT.md
• docs/OVERVIEW.md
• docs/DATA_MODEL.md
• docs/PRIVACY.md
• docs/PUBLISHING.md
• docs/GLAMA-CHECKLIST.md
• docs/GLAMA-DOCKERFILE.md
• scripts/glama-score-status.sh — 公開 Glama スコアのフラグ（inspectable/release/usage）を表示します