modou-tools-mcp

중국인 개발자를 위한 글로벌 기술 인텔리전스 데스크.

MCP 서버로, Agent에 장착하면 글로벌 기술 인텔리전스를 수집할 수 있습니다: 영문 측은 GitHub 트렌드, arXiv 논문, HN 인기 게시물, Exa 의미 검색, SEC 미국 주식 보고서; 중문 측은 掘金, 知乎, B站, A주 보고서까지 깊이 있게 다룹니다. 모든 도구는 API key 없음, 무료, 중국 내 직접 연결 — 이것이 Exa / Firecrawl / Perplexity처럼 구독과 key가 필요한 솔루션과의 가장 큰 차이점입니다.

빠른 시작（클라우드 호스팅 버전）

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 기술 방향” 조사

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 자체가 요약·정제), 서버는 경량 유지

• 제로 의존성: 선택적 GITHUB_TOKEN 외에 어떤 키도 필요 없음; Exa는 공식 무료 엔드포인트 사용

• 오류로 중단되지 않음: 단일 도구 실패 시 구조화된 오류를 반환하고, Agent는 경로를 바꿔 재시도 가능

환경 변수

개발

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

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

알려진 제한 사항

• web_search는 로컬 SearXNG(docker start searxng)에 의존하므로, 클라우드 호스팅 버전에서는 이 도구를 사용할 수 없습니다

• GitHub는 토큰 없이 시간당 60회만 가능(할당량 소진 시 403 안내); SEC는 간헐적 503 발생 시 재시도 가능; 东方财富 인터페이스는 간헐적 연결 끊김 발생(내장 재시도 3회)

• Exa 무료 엔드포인트는 할당량 제한이 있어 대량 호출 시 제한될 수 있습니다

• 掘金 사이트 내 검색 인터페이스는 로그인 상태가 필요하여 제공되지 않습니다; 掘金 기사 전문은 fetch_page와 함께 사용해야 합니다

• 스캔 버전 PDF는 is_scanned=true 경고를 반환합니다(OCR 없음)