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

Локальное развертывание (полный функционал)

Облачная версия из соображений совместимости не включает локальный поиск (см. известные ограничения). Для полного функционала запустите локально:

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

Агент получает исследовательскую задачу, 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 использует официальный бесплатный эндпоинт

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

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

Разработка

# 离线冒烟（结构检查，不依赖网络）
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)