연구 보고서: 업계 보고서 검색

이 MCP 서비스는 업계 보고서 검색을 핵심으로 하여, 업계 보고서, 기업 연구, 매크로 전략 및 테마 보고서의 검색과 상세 조회 기능을 제공합니다.

소속 분류: 종합 정보

주요 기능

• 업계 보고서 키워드 검색

• 기관 및 업종 필터링

• 보고서 유형 및 발행 시간 필터링

• 보고서 상세 정보 및 출처 링크

Related MCP server: worldbank-documents-reports-mcp

서비스 설계 설명

• 서비스는 검색과 상세 조회 두 가지 Tool을 통해 "보고서 발견—보고서 필터링—보고서 상세 조회"의 완전한 조회 체인을 완성합니다.

• 서비스는 2개의 읽기 전용 Tool을 제공하며, 단일 Tool 호출 시 하나의 Product ID만 접근합니다.

• 페이지네이션 결과는 total 및 resultList로 통일됩니다.

• 성공 응답은 Gateway 비즈니스 data 및 내부 stat/data 두 가지 형태를 자동으로 호환합니다.

• 요청 타임아웃은 HANDAAS_REQUEST_TIMEOUT으로 설정할 수 있으며, 기본값은 30초입니다.

환경 요구 사항

• Python 3.10+

• 의존성: mcp, python-dotenv, requests

로컬 빠른 시작

cd research-report-mcp-server
python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt
cp .env.example .env
python server/mcp_server.py streamable-http

서비스 기본 주소: http://127.0.0.1:8000/mcp. stdio, sse 및 streamable-http를 지원합니다.

환경 변수

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

실제 자격 증명은 로컬 .env 파일 또는 배포 키에만 저장해야 합니다.

Cursor / Cherry Studio 설정

{
  "mcpServers": {
    "research-report-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

사용 가능한 Tool 및 Product ID

권장 호출 흐름

1. research_report_search를 호출하여 보고서를 검색하고 후보 범위를 좁힙니다.

2. 제목, 기관, 업종, 유형 및 발행일을 기준으로 대상 보고서를 확인합니다.

3. 결과의 reportId를 사용하여 research_report_detail을 호출하고 전체 메타데이터 및 출처 링크를 가져옵니다.

Tool 상세 설명

1. research_report_search

사용 시기: 사용자가 특정 업종, 기업, 테마, 기관 또는 시간 범위 내의 보고서를 찾아야 할 때 사용합니다.

핵심 매개변수: rpKeyword는 보고서 제목 검색; rpOrgName은 기관 전체 이름 또는 약칭 검색; rpCalIndustryList 및 rpType은 정밀 필터링에 사용; 날짜 형식은 YYYY-MM-DD; pageSize 최대 50.

반환 설명: 보고서 제목, 기관, 발행일, 업종, 유형 및 reportId를 반환하며, 보고서 본문 파일은 반환하지 않습니다.

2. research_report_detail

사용 시기: 대상 보고서를 확인한 후, 기관, 업종, 유형, 발행일 및 출처 링크를 가져와야 할 때 사용합니다.

핵심 매개변수: reportId는 반드시 research_report_search의 결과에서 가져와야 합니다.

반환 설명: 보고서 메타데이터 및 출처 링크 필드를 반환합니다. Tool은 PDF 파일을 구매, 다운로드, 열기 또는 구문 분석하지 않습니다.

사용 예시

예시 1: 업계 보고서 검색

2026년에 발행된 인공지능 업계 보고서를 검색하고, 10건을 먼저 반환합니다.

{
  "tool": "research_report_search",
  "arguments": {
    "rpKeyword": "人工智能",
    "rpCalIndustryList": "人工智能",
    "rpPublishDateStart": "2026-01-01",
    "rpPublishDateEnd": "2026-12-31",
    "pageIndex": 1,
    "pageSize": 10
  }
}

예시 2: 보고서 상세 조회

방금 선택한 보고서의 발행 기관, 업종 분류, 발행일 및 출처 링크를 조회합니다.

{
  "tool": "research_report_detail",
  "arguments": {
    "reportId": "从研报检索结果取得"
  }
}

사용 주의사항

1. 상세 조회는 반드시 검색 결과의 reportId를 사용해야 합니다.

2. 시작 날짜는 종료 날짜보다 늦을 수 없습니다.

3. Tool은 출처 링크 메타데이터만 반환하며, 보고서 파일을 열거나, 구매, 다운로드 또는 구문 분석하지 않습니다.

4. 보고서의 관점은 원발행 기관에 속하며, MCP 서비스의 입장을 대표하지 않습니다.

테스트 검증

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

단위 테스트는 Mock 응답을 사용합니다. 실제 검증은 로컬 .env를 통해 HandaaS Integrator Gateway를 호출하여 수행합니다.