Skip to main content
Glama
modou-tools-mcp

modou-tools-mcp

by xihongshi567

modou-tools-mcp

Die globale Tech-Intelligence-Zentrale für chinesische Entwickler.

Ein MCP-Server, der in einen Agenten eingebaut werden kann, um globalen Tech-Intelligence zu sammeln: Auf der englischen Seite GitHub-Trends, arXiv-Paper, HN-Hotposts, Exa-Semantiksuche, SEC-US-Aktienberichte; auf der chinesischen Seite tief in 掘金, 知乎, B站, A-Aktien-Finanzberichte. Alle Tools ohne API-Key, ohne Kosten, direkt aus China erreichbar – das ist der größte Unterschied zu Lösungen wie Exa / Firecrawl / Perplexity, die Abonnements und Keys erfordern.

Schnellstart (Cloud-gehostete Version)

In MCP-fähigen Clients (Claude Code / Cherry Studio / Kimi Playground usw.) fügen Sie die folgende Konfiguration hinzu, um sich zu verbinden – ohne lokale Installation von Abhängigkeiten:

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

Related MCP server: Agent中国通

Lokale Bereitstellung (volle Funktionen)

Die Cloud-gehostete Version enthält aus Kompatibilitätsgründen keine lokale Suche (siehe bekannte Einschränkungen). Für volle Funktionen lokal ausführen:

# 本机 Python 环境(建议 3.10+)
pip install modou-tools-mcp
{
  "mcpServers": {
    "modou-tools": {
      "command": "uvx",
      "args": ["modou-tools-mcp@latest"]
    }
  }
}

Oder direkt mit dem Repository-Quellcode ausführen (Entwicklungsmodus):

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"

Tool-Liste

Tool

Zweck

Netzwerk

web_search

Chinesische Websuche (SearXNG-Aggregation, nur lokal verfügbar)

Lokal

fetch_page

Extraktion des Webseiten-Inhalts, entrauschte Ausgabe als Markdown (trafilatura)

Direkt

fetch_hot_topics

Aggregation von Trendlisten (知乎/B站/GitHub/HN)

Direkt

github_search_repos / github_compare_repos

GitHub-Repository-Trends/-Vergleich (60-mal/h, mit Token 5000-mal/h)

Direkt

arxiv_search

arXiv-Papersuche (unterstützt Kategorien/erweiterte Syntax, Sortierung nach Relevanz oder Datum)

Direkt

exa_search

Englische semantische Suche (Exa kostenloser Endpunkt, kein Key)

Direkt

juejin_recommended / juejin_by_category

Artikelentdeckung in der 掘金-Tech-Community (Empfehlungsfeed/Kategorie-Browsing)

Direkt

sec_company_facts / sec_compare_companies

US-Aktien-Finanzberichte (SEC EDGAR kostenlos)

Verfügbar, langsam

cninfo_company_profile / cninfo_financial_analysis / cninfo_compare_companies

A-Aktien-Finanzberichte (öffentliche Schnittstelle von 东方财富)

Direkt

parse_pdf

PDF-Bericht → Markdown + Tabellen (PyMuPDF)

Lokal

Alle Tools geben eine einheitliche Struktur zurück: bei Erfolg {"ok": true, ...}; bei Fehler {"ok": false, "error": "...", "detail": "..."}.

Ein vollständiges Szenario: Recherche zur „RAG-Technologierichtung“

Ein Agent erhält eine Rechercheaufgabe – modou-tools unterstützt die gesamte Kette:

  1. Eröffnung: exa_search("retrieval augmented generation trends 2026") – globale Trends ausloten

  2. Akademisches Update: arxiv_search("cat:cs.CL AND all:RAG") – neueste Paper ansehen

  3. Community beobachten: juejin_recommended / fetch_hot_topics(zhihu) – sehen, was im Inland diskutiert wird

  4. Originaltext holen: fetch_page(url) – den Inhalt von Schlüsselartikeln erfassen

  5. Bericht lesen: parse_pdf(url) – PDF-Whitepaper parsen

  6. Daten prüfen: github_search_repos("RAG framework") – Projekt-Hype ansehen

Designprinzipien

  • Reine Erfassung: keine LLM-Verarbeitung (der Agent selbst fasst zusammen und destilliert), der Server bleibt leichtgewichtig

  • Null Abhängigkeiten: außer dem optionalen GITHUB_TOKEN ist kein Key erforderlich; Exa nutzt den offiziellen kostenlosen Endpunkt

  • Fehler unterbrechen nicht: Ein einzelner Tool-Fehler gibt einen strukturierten Fehler zurück, der Agent kann andere Wege gehen und es erneut versuchen

Umgebungsvariablen

Variable

Beschreibung

Erforderlich

GITHUB_TOKEN

GitHub-API-Token, erhöht das Rate-Limit auf 5000 Anfragen/h

Optional

Entwicklung

# 离线冒烟(结构检查,不依赖网络)
python smoke_test.py

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

Bekannte Einschränkungen

  • web_search hängt von lokalem SearXNG ab (docker start searxng); in der Cloud-gehosteten Version ist dieses Tool nicht verfügbar

  • GitHub ohne Token nur 60-mal/h (bei erschöpftem Kontingent wird eine 403-Meldung zurückgegeben); SEC gelegentlich 503 – erneut versuchen; 东方财富-Schnittstelle gelegentlich getrennt (integrierter 3-maliger Retry)

  • Der kostenlose Exa-Endpunkt hat ein Limit; bei starker Nutzung kann er eingeschränkt sein

  • Die 掘金-Suchschnittstelle erfordert einen Login und wird nicht bereitgestellt; für 掘金-Artikelvolltexte muss fetch_page verwendet werden

  • Gescannte PDFs geben eine Warnung is_scanned=true zurück (keine 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.
      -