Skip to main content
Glama
modou-tools-mcp

modou-tools-mcp

by xihongshi567

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

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

인기 순위 집계(知乎/B站/GitHub/HN)

직접 연결

github_search_repos / github_compare_repos

GitHub 저장소 트렌드/비교(시간당 60회, 토큰 설정 시 시간당 5000회)

직접 연결

arxiv_search

arXiv 논문 검색(분류/고급 구문 지원, 관련도 또는 최신순 정렬)

직접 연결

exa_search

영문 의미 검색(Exa 무료 엔드포인트, key 불필요)

직접 연결

juejin_recommended / juejin_by_category

掘金 기술 커뮤니티 아티클 발견(추천 피드/카테고리 탐색)

직접 연결

sec_company_facts / sec_compare_companies

미국 주식 재무 보고서(SEC EDGAR 무료)

사용 가능, 다소 느림

cninfo_company_profile / cninfo_financial_analysis / cninfo_compare_companies

A주 재무 보고서(东方财富 공개 인터페이스)

직접 연결

parse_pdf

PDF 보고서 → Markdown + 표(PyMuPDF)

로컬

모든 도구는 통일된 구조를 반환합니다: 성공 시 {"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는 경로를 바꿔 재시도 가능

환경 변수

변수

설명

필수

GITHUB_TOKEN

GitHub API 토큰, 속도 제한을 시간당 5000회로 상향

선택

개발

# 离线冒烟(结构检查,不依赖网络)
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 없음)

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