Skip to main content
Glama
modou-tools-mcp

modou-tools-mcp

by xihongshi567

modou-tools-mcp

Глобальный технологический информационный центр для китайских разработчиков.

Это MCP-сервер, позволяющий агенту собирать глобальную техническую информацию: с англоязычной стороны — тренды GitHub, статьи arXiv, горячие посты HN, семантический поиск Exa, отчёты SEC по американским акциям; с китайской стороны — глубокая работа с Juejin, Zhihu, Bilibili и отчётами по A-акциям. Все инструменты без API-ключей, бесплатны, прямой доступ из Китая — это главное отличие от таких решений, как 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

Агрегация горячих списков (Zhihu / Bilibili / GitHub / HN)

Прямой доступ

github_search_repos / github_compare_repos

Тренды/сравнение репозиториев GitHub (60 раз/ч, с токеном 5000 раз/ч)

Прямой доступ

arxiv_search

Поиск статей arXiv (поддержка категорий/продвинутого синтаксиса, сортировка по релевантности или новизне)

Прямой доступ

exa_search

Семантический поиск на английском (бесплатный эндпоинт Exa, без ключа)

Прямой доступ

juejin_recommended / juejin_by_category

Обнаружение статей в техническом сообществе Juejin (рекомендуемые / просмотр по категориям)

Прямой доступ

sec_company_facts / sec_compare_companies

Отчёты американских компаний (SEC EDGAR, бесплатно)

Доступно, медленно

cninfo_company_profile / cninfo_financial_analysis / cninfo_compare_companies

Отчёты по A-акциям (публичный API East Money)

Прямой доступ

parse_pdf

PDF-отчёты → Markdown + таблицы (PyMuPDF)

Локально

Все инструменты возвращают единую структуру: при успехе {"ok": true, ...}; при ошибке {"ok": false, "error": "...", "detail": "..."}.

Полный сценарий: исследование «направление технологии RAG»

Агент получает исследовательскую задачу, 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 (агент сам обобщает и выделяет главное), сервер остаётся лёгким

  • Ноль зависимостей: не нужны никакие ключи, кроме опционального GITHUB_TOKEN; Exa использует официальный бесплатный эндпоинт

  • Ошибки не прерывают: при сбое инструмента возвращается структурированная ошибка, агент может выбрать другой путь и повторить

Переменные окружения

Переменная

Описание

Обязательна

GITHUB_TOKEN

API-токен GitHub, повышает лимит запросов до 5000 раз/ч

Необязательно

Разработка

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

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

Известные ограничения

  • web_search зависит от локального SearXNG (docker start searxng); в облачной версии этот инструмент недоступен

  • GitHub без токена — только 60 раз/ч (при исчерпании квоты возвращает 403); SEC иногда отдаёт 503, можно повторить; API East Money иногда обрывается (встроено 3 повтора)

  • У бесплатного эндпоинта Exa есть квоты; при большом количестве вызовов доступ может быть ограничен

  • API поиска внутри Juejin требует авторизации и не предоставляется; для полного текста статей Juejin используйте 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.

    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.
      -