modou-tools-mcp

中国語開発者のためのグローバル技術インテリジェンスプラットフォーム。

MCP サーバーを Agent に組み込むだけで、グローバルな技術情報を収集できます。英語側では GitHub トレンド、arXiv 論文、HN ホットトピック、Exa セマンティック検索、SEC 米国株財務報告を確認。中国語側では掘金、知乎、B站、A株財務報告を深掘りします。すべてのツールは API key 不要、無料、国内直結 ——これは、サブスクリプションや key が必要な Exa / Firecrawl / Perplexity などのサービスとの最大の違いです。

クイックスタート（クラウドホスト版）

MCP に対応したクライアント（Claude Code / Cherry Studio / Kimi Playground など）に以下の設定を追加するだけで接続できます。ローカルに依存関係をインストールする必要はありません：

{
  "mcpServers": {
    "modou-tools": {
      "command": "uvx",
      "args": ["modou-tools-mcp@latest"]
    }
  }
}

ローカルデプロイ（完全な機能）

クラウドホスト版は互換性のためローカル検索を含みません（既知の制限を参照）。完全な機能が必要な場合は、ローカルで実行します：

# 本机 Python 环境（建议 3.10+）
pip install modou-tools-mcp

{
  "mcpServers": {
    "modou-tools": {
      "command": "uvx",
      "args": ["modou-tools-mcp@latest"]
    }
  }
}

またはリポジトリのソースコードを直接使って実行します（開発モード）：

git clone https://github.com/xihongshi567/modou-tools-mcp
cd modou-tools-mcp
pip install -e .
claude mcp add modou-tools -- python "D:/okok/modou-tools-mcp/src/modou_tools_mcp/server.py"

ツール一覧

すべてのツールは統一された構造を返します：成功時は {"ok": true, ...}、失敗時は {"ok": false, "error": "...", "detail": "..."}。

完全なシナリオ：「RAG 技術動向」の調査

Agent が調査タスクを受け取ったとき、modou-tools が全工程をサポートします：

1. テーマ設定：exa_search("retrieval augmented generation trends 2026") で世界のトレンドを探る

2. 学術補完：arxiv_search("cat:cs.CL AND all:RAG") で最新の論文を確認

3. コミュニティ確認：juejin_recommended / fetch_hot_topics(zhihu) で国内の話題を確認

4. 原文取得：fetch_page(url) で重要な記事の本文を取得

5. レポート閲覧：parse_pdf(url) で PDF ホワイトペーパーを解析

6. データ調査：github_search_repos("RAG framework") でプロジェクトの人気を確認

設計原則

• 純粋な収集：LLM による加工は行わない（Agent 自身が要約・抽出）、server は軽量を維持

• ゼロ依存：任意の GITHUB_TOKEN 以外に key は不要；Exa は公式の無料エンドポイントを利用

• エラーで中断しない：単一ツールの失敗は構造化エラーを返し、Agent は経路を変えて再試行できる

環境変数

開発

# 离线冒烟（结构检查，不依赖网络）
python smoke_test.py

# 在线验证全部工具
python scripts/verify_online.py

既知の制限

• web_search はローカルの SearXNG に依存（docker start searxng）、クラウドホスト版ではこのツールは利用不可

• GitHub は token なしでは 60回/h のみ（クォータ枯渇時は 403 を返す）；SEC は稀に 503 を返すため再試行可能；东方财富の API は稀に切断が発生（内蔵リトライ 3 回）

• Exa の無料エンドポイントにはクォータ制限があり、大量呼び出し時に制限される可能性がある

• 掘金のサイト内検索 API はログイン状態が必要なため提供していない；掘金記事の全文は fetch_page と併用する必要がある

• スキャン版 PDF は is_scanned=true の警告を返す（OCR なし）