Scout Mcp

scout-mcp

21 のプラットフォームを並列検索し、構造化された JSON を返す MCP サーバーです。Model Context Protocol SDK を使用して構築されています。

Claude Desktop、VS Code、Cursor、または任意の MCP クライアントに接続すると、1 回のツール呼び出しでコードレジストリ、学術論文、ソーシャルプラットフォーム、テックブログを検索できます。

ツール

ツール	ソース	備考
hackernews_search	Hacker News (Algolia)	ストーリー、コメント、投票
github_search	GitHub	キーワードによるリポジトリ検索
github_repo_info	GitHub	単一リポジトリの詳細
npm_search	npm Registry	パッケージ
pypi_search	PyPI	Python パッケージ
producthunt_search	Product Hunt	トピック別のプロダクト
x_search	X / Twitter	xAI Grok による AI 検索（XAI_API_KEY が必要）
devto_search	Dev.to	記事
hashnode_search	Hashnode	記事（GraphQL）
lobsters_search	Lobste.rs	ストーリー
stackexchange_search	StackExchange	全サイトの Q&A
arxiv_search	ArXiv	学術論文
reddit_search	Reddit	投稿とコメント
youtube_search	YouTube	動画（YOUTUBE_API_KEY が必要）
zenn_search	Zenn	日本語の技術記事
qiita_search	Qiita	日本語の技術記事
semantic_scholar_search	Semantic Scholar	学術論文
lemmy_search	Lemmy	Fediverse の投稿
gitlab_search	GitLab	プロジェクト
bazaar_search	x402 Bazaar	x402 API ディレクトリ
scout_report	マルチソース	選択したソースを並列検索

クイックスタート

Claude Desktop / VS Code / Cline

git clone https://github.com/bartonguestier1725-collab/scout-mcp.git
cd scout-mcp && npm install && npm run build

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "scout": {
      "command": "node",
      "args": ["/absolute/path/to/scout-mcp/build/index.js"]
    }
  }
}

Docker

docker build -t scout-mcp .
docker run -i scout-mcp

Dockerfile は、stdio 経由で MCP サーバーを実行する最小構成の node:24-alpine イメージをビルドします。

設定

すべての設定は環境変数で行います。ほとんどのツールはキーなしで動作します。オプションのキーを設定すると、追加のソースを利用できるようになったり、レート制限が緩和されたりします。

変数	必須	説明
XAI_API_KEY	x_search に必要	X/Twitter 検索用の xAI API キー
GITHUB_TOKEN	推奨	GitHub のレート制限を緩和
YOUTUBE_API_KEY	youtube_search に必要	YouTube Data API v3 キー
PH_CLIENT_ID / PH_CLIENT_SECRET	producthunt_search に必要	Product Hunt API 認証情報
REDDIT_CLIENT_ID / REDDIT_CLIENT_SECRET	reddit_search に必要	Reddit API 認証情報
QIITA_TOKEN	オプション	Qiita のレート制限を緩和
S2_API_KEY	オプション	Semantic Scholar 専用のレート制限
SE_API_KEY	オプション	StackExchange 専用のレート制限

仕組み

各ツールはソースの API を直接呼び出し、レスポンスを解析して、一貫したフィールド（title、url、source、created_at など）を持つ正規化された JSON を返します。scout_report ツールは Promise.allSettled を使用して複数の検索を並列実行するため、1 つのソースでエラーが発生しても、ほかの検索は妨げられません。

トランスポート：stdio（標準の MCP トランスポート）。サーバーは stdin から JSON-RPC メッセージを読み込み、stdout にレスポンスを書き込みます。

HTTP モード

scout-mcp は、x402 protocol（Base 上での USDC マイクロペイメント）を介して、https://scout.hugen.tokyo で有料 HTTP API としても動作します。このモードでは同じツール実装を使用しつつ、決済ミドルウェアを備えた REST エンドポイントとして公開します。

ライセンス

MIT