Scout Mcp

scout-mcp

一个 MCP 服务，可并行搜索 21 个平台并返回结构化 JSON。基于 Model Context Protocol SDK 构建。

将其连接到 Claude Desktop、VS Code、Cursor 或任何 MCP 客户端，即可通过一次工具调用搜索代码仓库、学术论文、社交平台和技术博客。

工具

工具	来源	说明
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	所有站点的问答
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 会构建一个精简的 node:24-alpine 镜像，通过 stdio 运行 MCP 服务。

配置

所有配置均通过环境变量完成。大多数工具无需任何密钥即可使用。可选密钥可启用其他来源或提高速率限制。

变量	必需项	说明
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、解析响应，并返回字段统一的标准化 JSON（title、url、source、created_at 等）。scout_report 工具使用 Promise.allSettled 并行运行多项搜索，因此某个来源失败不会影响其他来源。

传输方式：stdio（标准 MCP 传输方式）。服务从 stdin 读取 JSON-RPC 消息，并将响应写入 stdout。

HTTP 模式

scout-mcp 也以付费 HTTP API 的形式运行，网址为 https://scout.hugen.tokyo，采用 x402 协议（在 Base 上使用 USDC 进行微支付）。此模式使用相同的工具实现，但通过支付中间件将其作为 REST 端点提供。

许可证

MIT