Skip to main content
Glama
modou-tools-mcp

modou-tools-mcp

by xihongshi567

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"]
    }
  }
}

Related MCP server: Agent中国通

ローカルデプロイ(完全な機能)

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

# 本机 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"

ツール一覧

ツール

用途

ネットワーク

web_search

中国語ウェブ検索(SearXNG 集約、ローカルデプロイでのみ利用可能)

ローカル

fetch_page

ウェブページ本文の抽出、ノイズ除去して Markdown を出力(trafilatura)

直結

fetch_hot_topics

ホットランキング集約(知乎/B站/GitHub/HN)

直結

github_search_repos / github_compare_repos

GitHub リポジトリのトレンド/比較(60回/h、token 併用で5000回/h)

直結

arxiv_search

arXiv 論文検索(分類/高度な構文に対応、関連度または最新順)

直結

exa_search

英語セマンティック検索(Exa 無料エンドポイント、key 不要)

直結

juejin_recommended / juejin_by_category

掘金技術コミュニティの記事発見(おすすめフィード/カテゴリ別閲覧)

直結

sec_company_facts / sec_compare_companies

米国株の財務報告(SEC EDGAR 無料)

利用可、やや遅い

cninfo_company_profile / cninfo_financial_analysis / cninfo_compare_companies

A株の財務報告(东方财富の公開API)

直結

parse_pdf

PDF レポート → Markdown + テーブル(PyMuPDF)

ローカル

すべてのツールは統一された構造を返します:成功時は {"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 は経路を変えて再試行できる

環境変数

変数

説明

必須

GITHUB_TOKEN

GitHub API token、レート制限を5000回/hに引き上げ

任意

開発

# 离线冒烟(结构检查,不依赖网络)
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 なし)

Available Tools

15 tools
cninfo_company_profileCninfo Company ProfileB

查询 A股公司基本信息(东方财富公开接口)。

Inputs: code (required), market. Returns: object

cninfo_compare_companiesCninfo Compare CompaniesA

对比多家 A股公司最新财年核心指标。

Inputs: codes (required), years. Returns: object

cninfo_financial_analysisCninfo Financial AnalysisA

查询 A股公司财务分析指标(ROE/净利率/营收增速/毛利率/研发占比)。

Inputs: code (required), years. Returns: object

fetch_hot_topicsFetch Hot TopicsA

获取主流平台当前热搜榜单(zhihu 知乎 / bilibili B站 / github GitHub 趋势 / hackernews HN)。

Inputs: platforms. Returns: object

fetch_pageFetch PageA

抓取网页正文,自动去广告/导航/侧边栏,输出干净 Markdown(trafilatura)。

Inputs: url (required), max_chars, include_links. Returns: object

github_compare_reposGithub Compare ReposB

对比多个 GitHub 仓库的当前快照数据。

Inputs: repos (required). Returns: object

github_search_reposGithub Search ReposA

搜索 GitHub 仓库趋势,把技术趋势翻译成数字(stars/forks/活跃度)。

Inputs: query (required), sort, limit. Returns: object

juejin_by_categoryJuejin By CategoryB

按分类浏览掘金文章(ai / frontend / backend / android / ios / freebie / article)。

Inputs: category (required), limit. Returns: object

parse_pdfParse PdfA

解析 PDF 报告为 Markdown(保留表格),本地文件或在线 URL 均可。

Inputs: url, file_path, max_pages, extract_tables. Returns: object

sec_company_factsSec Company FactsB

查询美股公司财报(SEC EDGAR),拿营收/净利/研发支出等结构化数据。

Inputs: cik, years, ticker, metrics. Returns: object

sec_compare_companiesSec Compare CompaniesA

对比多家美股公司同一财年的核心指标。

Inputs: tickers (required), years, metrics. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 15 tools

    Disambiguation4/5

    Tools are mostly distinct by source and purpose (search vs. compare vs. fetch vs. parse), but a few could be confused: web_search vs exa_search both handle search, and juejin_recommended vs juejin_by_category both return Juejin articles.

    Naming Consistency3/5

    All names use snake_casecars but follow inconsistent patterns: some are source_verb_object (github_search_repos), some are verb_object (fetch_page), and some are source_attribute (juejin_recommended, cninfo_company_profile). The naming is readable but not fully predictable.

    Tool Count4/5

    15 tools is at the upper boundary of a reasonable scope for a research/investment aggregation servercars. Each tool maps to a distinct data source or operation, though the count is getting close to heavy.

    Completeness4/5

    Covers searching, fetching content, financial data, and comparison workflows across multiple sources. Minor gaps exist (e.g., no explicit historical data beyond current snapshots, no saved/watchlist functionality), but core research workflows are complete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server optimized for Chinese users that enables AI models to perform Bing searches and fetch webpage content without requiring an API key. It provides specialized tools for searching and scraping web data directly through supported AI environments like Claude or Cursor.
      25 npm
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      这是一个面向中文圈的MCP服务器,将中国互联网常用能力(如地图、快递、RSS、B站等)封装为标准MCP工具,方便AI Agent安全调用。
      13
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that aggregates AI news, academic papers from ArXiv, and trending GitHub repositories from multiple sources, enabling users to fetch, search, and filter recent AI content via natural language.
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      This MCP server enables AI agents to read and search the internet without paid API keys, supporting multiple channels like web, GitHub, RSS, YouTube, and more, with automatic browser escalation and caching.
      -