modou-tools-mcp

Plataforma global de inteligencia tecnológica para desarrolladores chinos.

Un servidor MCP que, integrado en un Agent, permite recolectar inteligencia tecnológica global: del lado inglés, tendencias de GitHub, artículos de arXiv, publicaciones populares de HN, búsqueda semántica de Exa y reportes financieros de acciones estadounidenses de SEC; del lado chino, se adentra en Juejin, Zhihu, Bilibili y reportes financieros de acciones A. Todas las herramientas con cero API key, cero coste y acceso directo nacional — esta es la mayor diferencia frente a soluciones como Exa / Firecrawl / Perplexity que requieren suscripción y clave.

Inicio rápido (versión alojada en la nube)

En un cliente compatible con MCP (Claude Code / Cherry Studio / Kimi Playground, entre otros), añada la siguiente configuración para conectarse, sin necesidad de instalar ninguna dependencia local:

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

Despliegue local (funcionalidad completa)

La versión alojada en la nube no incluye, por razones de compatibilidad, la búsqueda local (ver limitaciones conocidas). Cuando necesite la funcionalidad completa, ejecútelo localmente:

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

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

O ejecútelo directamente con el código fuente del repositorio (modo de desarrollo):

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"

Lista de herramientas

Todas las herramientas devuelven una estructura unificada: éxito {"ok": true, ...}; error {"ok": false, "error": "...", "detail": "..."}.

Un escenario completo: investigar la "dirección de la tecnología RAG"

Cuando el Agent recibe una tarea de investigación, modou-tools la respalda en toda la cadena:

1. Inicio: exa_search("retrieval augmented generation trends 2026") para sondear las tendencias globales

2. Complemento académico: arxiv_search("cat:cs.CL AND all:RAG") para ver los artículos más recientes

3. Ver la comunidad: juejin_recommended / fetch_hot_topics(zhihu) para ver de qué se habla en China

4. Obtener el original: fetch_page(url) para extraer el contenido de los artículos clave

5. Leer informes: parse_pdf(url) para analizar PDFs de libros blancos

6. Consultar datos: github_search_repos("RAG framework") para ver la popularidad de los proyectos

Principios de diseño

• Recopilación pura: no se realiza procesamiento con LLM (el propio Agent resume y sintetiza), el servidor se mantiene ligero

• Cero dependencias: no se necesita ninguna API key aparte de la opcional GITHUB_TOKEN; Exa utiliza el endpoint gratuito oficial

• Los errores no interrumpen: si una herramienta individual falla, se devuelve un error estructurado y el Agent puede cambiar de vía y reintentar

Variables de entorno

Desarrollo

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

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

Limitaciones conocidas

• web_search depende de SearXNG local (docker start searxng); esta herramienta no está disponible en la versión alojada en la nube

• GitHub sin token solo permite 60 veces/h (cuando se agota la cuota, devuelve un aviso 403); SEC ocasionalmente devuelve 503, se puede reintentar; la API de 东方财富 ocasionalmente se desconecta (reintento incorporado de 3 veces)

• El endpoint gratuito de Exa tiene límites de cuota; puede verse limitado al hacer muchas llamadas

• La API de búsqueda interna de Juejin requiere estado de inicio de sesión y no se ofrece; el texto completo de los artículos de Juejin requiere el uso adicional de fetch_page

• Los PDF escaneados devuelven una advertencia is_scanned=true (sin OCR)