Research Scope

research-scope-mcp

散在する情報源を、意思決定にすぐ活用でき、追跡可能なレポートに変えます。

research-scope-mcp は、あらゆる MCP クライアントが最初から最後まで実行できる、調査からレポート作成までのワークフローを提供する MCP サーバーです。

1. plan_research(scope) — 調査範囲を情報源の調査計画に変換し、中止基準を設けます（「一次情報源が1件未満、かつ独立した二次情報源が2件未満の場合は中止し、情報源不足を報告する。根拠の乏しい状態で先に進まない」）。
2. fetch_and_score(source_url) — 情報源を1件クロールし、説明可能な0～100の品質スコアを返します。一次情報源の検出、公開日の新しさ、有料記事および利益相反のフラグなど、すべての評価項目を根拠とともに返します。
3. build_report(topic, sources) — スコア付け済みの情報源を使って、引用レジストリ付きレポートのひな形（主張セクション＋番号付きレジストリ＋スコアリング付録）を作成します。
4. check_report(report) — 実質的な主張すべてに、スコア付け済みの情報源が1件以上引用されていることを検証します。出典のない主張がある場合は、合格ではなくエラー一覧を返します。

解決する課題は、確信に満ちた印象を与えながら、文の出典を示せないエージェント作成のレポートです。このサーバーは、スコアリングと引用の網羅性を機械的に強制するため、人間が90秒で監査できるレポートを作成できます。

インストール

npm install -g research-scope-mcp   # once published; local: npm ci && npm run build

stdio で実行する場合（ほとんどのクライアント向け）：

npx research-scope-mcp

または、Streamable HTTP で実行する場合（リモート環境向け）：

npx research-scope-mcp --http --port 3001
# unauthenticated requests get 401 + WWW-Authenticate discovery, never a bare 403

クライアント設定

Claude Code、Cursor、および Cline で使用できるllms-install.mdの設定スニペットを用意しています。

Docker

docker build -t research-scope-mcp -f docker/Dockerfile .
docker run --rm -i -p 3001:3001 research-scope-mcp --http --port 3001

ツール

ツール	入力	出力
plan_research	scope、省略可能な domain_hints	中止基準付きの情報源調査計画
fetch_and_score	source_url	0～100のスコア＋フラグ（一次情報源、新しさ、有料記事、COI）。レポート用に登録
build_report	topic、sources[]（スコア付け済みであること）	data/reports/ に保存されるレポートのひな形、[Sn] 形式の引用番号
check_report	report_id または report_path	合否＋出典のない主張のエラー一覧

実行例

入力と出力を含む2つの実行例はdocs/runs/を、タイムアウトや401エラーが発生した場合の対処方法はdocs/notes/を参照してください。

デモの記録

npm run demo:capture（または node tools/demo-capture.mjs）を実行すると、同梱サーバーを使って、スクリプト化された60秒のデモフローを再生します。新しい一時データディレクトリでstdio経由でdist/index.jsを起動し、plan_research → .govページのfetch_and_score（実際に取得）→ build_reportを実行します。引用付きの主張を1つと、意図的に出典を付けない主張を1つ挿入し、check_reportが承認を拒否することを確認したうえで、各フレームを{t, dir, msg}形式のJSONLトランスクリプトとして書き出します。既定ではdocs/marketing/demo-60s/run-capture.jsonlを対象にします（このトランスクリプトには、製品ページのデモプレーヤーのフッターにあるsha256がひも付けられています）。--forceを指定しない限り、このファイルへの上書きは拒否されます。実際の取得を1回行うため、ネットワークアクセスが必要です。リポジトリのdata/は変更されません。

スコアリング基準

評価項目	最大点	備考
利用可能性と内容	20	抽出可能なテキストの長さ
一次情報源としての適格性	32	ホストの分類（gov/edu/filings）、または自己公開された一次情報（プレスリリース／発表ページ）
新しさ	24	30日以内は満点、5年超で2点まで低下、判定不能の場合は0点
アクセス	12	有料記事や登録の壁がある場合は減点
独立性	12	スポンサー、アフィリエイト、提携を示すマーカー

score ≥ 80 → A、≥ 65 → B、≥ 45 → C、それ未満はDです。評価基準はsrc/scoring/score.tsにあり、根拠も返すため、スコアは雰囲気ではなく監査可能です。

ライセンス

MIT。セキュリティ上の問題の報告についてはSECURITY.mdを参照してください。

有料キット

このサーバーはResearch-to-Report MCP Kit（フィールドガイド、実例パック、セットアップサポート）の、無料でテスト済みの中核部分です。キットストアで入手できます。リンクはCHANGELOG.mdの更新をご確認ください。