정보 빅데이터 서비스

이 MCP 서비스는 기업 키워드 검색, 전체 영역 정보 검색, 기업 정보, 산업 정보, 주제 추적 및 기업 동향 모니터링 기능을 제공하여 사용자가 산업 연구, 핫이슈 추적, 기업 여론 및 브랜드 평판 관리를 수행할 수 있도록 돕습니다.

주요 기능

• 🏢 기업 약칭 및 키워드 검색

• 🔍 전체 영역 정보 키워드 검색

• 🏢 기업 뉴스 여론 조회

• 🏭 산업 및 분야 정보 검색

• 🎯 정책, 기술, 브랜드 및 이벤트 주제 추적

• 📊 기업 정보 상세 및 감성 통계 모니터링

Related MCP server: industry-chain-mcp-server

서비스 설계 설명

• 서비스는 실제 비즈니스 시나리오에 따라 6개의 Tool을 제공하며, 상위 API 수에 따라 도구를 나열하지 않습니다.

• 사용자가 기업 약칭만 제공하는 경우 먼저 information_enterprise_search를 사용하여 기업 전체 이름 또는 안정적인 ID를 얻습니다.

• 검색, 산업 및 주제 Tool은 동일한 전체 영역 정보 검색 Product ID를 재사용하지만, 서로 다른 시나리오 의미를 유지합니다.

• 상위 정보 검색 결과는 MCP 계층에서 pageIndex와 pageSize로 페이지네이션되며, 기본적으로 페이지당 20건, 최대 50건입니다.

• 검색 결과는 기본적으로 긴 본문을 반환하지 않습니다. includeContent=true로 설정하면 contentMaxChars를 통해 각 본문의 길이를 제한할 수 있습니다.

• information_monitor는 view를 통해 상세 또는 통계를 선택하며, 한 번에 하나의 Product ID만 접근합니다.

• 모든 페이지네이션 응답의 비즈니스 외부 레이어에는 total과 resultList만 포함됩니다.

환경 요구 사항

• Python 3.10+

• 의존 패키지: python-dotenv, requests, mcp

로컬 빠른 시작

1. 프로젝트 디렉터리로 이동

cd information-mcp-server

2. 가상 환경 생성 및 의존성 설치

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. 환경 변수 구성

환경 변수 템플릿을 복사합니다:

cp .env.example .env

.env 파일을 편집합니다:

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

HANDAAS_REQUEST_TIMEOUT는 선택 구성이며 단위는 초이고 기본값은 30입니다.

4. Streamable HTTP 서비스 시작

python server/mcp_server.py streamable-http

서비스 기본 주소는 http://localhost:8000/mcp입니다.

시작 스크립트를 사용할 수도 있습니다:

./start_mcp_server.sh streamable-http

stdio, sse, streamable-http 세 가지 시작 방식을 지원합니다.

5. Cursor / Cherry Studio MCP 구성

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

STDIO 버전 설치 및 배포

{workdir}를 information-mcp-server의 절대 경로로 바꿉니다:

{
  "mcpServers": {
    "information-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID, SECRET_ID, SECRET_KEY는 HandaaS에 로그인하여 가입하고 커넥터를 활성화한 후에 얻을 수 있습니다. 실제 자격 증명은 로컬 .env 또는 배포 키에만 저장해야 합니다.

사용 가능한 Tool 및 Product ID

1. information_enterprise_search

기능: 기업 약칭, 브랜드, 제품 또는 기타 키워드로 후보 기업을 검색합니다.

주요 매개변수: matchKeyword 필수; pageIndex 기본 1; pageSize 기본 10, 최대 50.

반환: 후보 기업 total/resultList. 기업을 확인한 후 기업 전체 이름, 기업 ID 또는 통일사회신용코드를 기업 정보 및 모니터링 Tool에 사용합니다.

2. information_search

기능: 키워드로 뉴스 정보 제목과 본문을 검색합니다.

주요 매개변수:

• matchKeyword（필수）: 검색 키워드.

• pubDateBegin, pubDateEnd（선택）: 발행 시간 시작 및 종료 조건.

• pageIndex（선택）: MCP 반환 페이지 번호, 1부터 시작.

• pageSize（선택）: 페이지당 수량, 기본 20, 최대 50.

• includeContent（선택）: 정보 본문 반환 여부, 기본 false.

• contentMaxChars（선택）: 본문 반환 시 항목당 최대 보존 문자 수, 기본 1000, 범위 100–5000.

반환: total 및 resultList; 결과에는 제목, 출처, 발행 시간, 정보 링크 및 필요에 따라 잘린 본문이 포함될 수 있습니다.

3. information_company_news

기능: 지정된 기업의 뉴스 여론 상세를 조회합니다.

주요 매개변수:

• matchKeyword（필수）: 기업 이름, 기업 ID, 등록번호 또는 통일사회신용코드.

• keywordType（선택）: 기업 식별 유형, name, nameId, regNumber, socialCreditCode 지원.

• pageIndex（선택）: 페이지 번호, 1부터 시작.

• pageSize（선택）: 페이지당 수량, 기본 50, 최대 50.

• sentimentLabel（선택）: 0 부정, 1 긍정, 2 중립, 3 알 수 없음.

반환: total 및 resultList; 결과에는 뉴스 요약, 링크, 출처, 제목, 발행 시간, 관련 기업 및 감성 라벨이 포함될 수 있습니다.

4. information_industry_news

기능: 산업, 분야 또는 업종 키워드로 정보를 검색하여 산업 연구 및 시장 동향 분석에 사용합니다.

주요 매개변수:

• matchKeyword（필수）: 산업, 분야 또는 업종 키워드.

• pubDateBegin, pubDateEnd（선택）: 발행 시간 범위.

• pageIndex, pageSize（선택）: 페이지 번호 및 페이지당 수량, pageSize 최대 50.

• includeContent, contentMaxChars（선택）: 본문 반환 스위치 및 본문 길이 상한.

반환: total 및 resultList.

5. information_topic

기능: 정책, 기술, 브랜드 또는 핫이슈 등 명확한 주제를 추적합니다.

주요 매개변수:

• matchKeyword（필수）: 구체적인 주제 또는 이벤트 키워드.

• pubDateBegin, pubDateEnd（선택）: 주제 관찰 시간 범위.

• pageIndex, pageSize（선택）: 페이지 번호 및 페이지당 수량, pageSize 최대 50.

• includeContent, contentMaxChars（선택）: 본문 반환 스위치 및 본문 길이 상한.

반환: total 및 resultList.

6. information_monitor

기능: 기업 정보 동향을 모니터링하며, 뉴스 이벤트 상세 또는 감성 통계 뷰를 선택할 수 있습니다.

주요 매개변수:

• matchKeyword（필수）: 기업 이름, 기업 ID, 등록번호 또는 통일사회신용코드.

• view（선택）: details 뉴스 이벤트 상세; statistics 감성 분포 및 추세. 기본 statistics.

• keywordType（선택）: 기업 식별 유형.

• pageIndex, pageSize（선택）: details 뷰에서만 사용, pageSize 최대 50.

• sentimentLabel（선택）: details 뷰에서만 사용하는 감성 필터.

반환: 상세 뷰는 total 및 resultList를 반환하고, 통계 뷰는 감성 분포 및 추세 비즈니스 필드를 반환합니다.

사용 시나리오

1. 기업 식별: 약칭 또는 브랜드 키워드를 통해 기업 전체 이름과 안정적인 식별자를 확인합니다.

2. 정보 검색: 키워드로 전체 영역 뉴스 제목, 출처, 시간 및 링크를 집계합니다.

3. 산업 연구: 산업, 분야 및 업종 관련 동향을 추적합니다.

4. 주제 추적: 정책, 기술, 브랜드 및 핫이슈를 지속적으로 관찰합니다.

5. 기업 여론: 기업 관련 뉴스를 조회하고 감성 범주별로 필터링합니다.

6. 동향 모니터링: 기업 정보의 감성 분포와 변화 추세를 분석합니다.

7. 브랜드 평판 관리: 뉴스 상세와 감성 통계를 결합하여 평판 위험을 식별합니다.

사용 시 주의사항

1. 약칭 처리: 기업 약칭으로 직접 조회할 수 없는 경우 먼저 information_enterprise_search를 호출합니다.

2. 시나리오 선택: 기업 여론은 information_company_news 또는 information_monitor를 사용하고, 산업 연구는 information_industry_news를 사용합니다.

3. 페이지네이션 제한: pageIndex는 1부터 시작하며, pageSize는 1에서 50 사이여야 합니다.

4. 본문 제어: 기본적으로 informationText를 반환하지 않습니다. 본문이 필요하면 includeContent=true를 명시적으로 설정합니다.

5. 본문 길이: contentMaxChars는 100에서 5000 사이여야 합니다.

6. 감성 라벨: 0은 부정, 1은 긍정, 2는 중립, 3은 알 수 없음을 나타냅니다.

7. 정상적인 빈 결과: 키워드, 시간 또는 감성 조건과 일치하는 항목이 없으면 total=0 및 빈 resultList가 반환될 수 있습니다.

사용 질문 예시

information_enterprise_search（기업 키워드 검색）

1. “小米”에 해당하는 기업은 무엇인가요?

2. “格力”를 사용하여 정확한 기업 이름과 기업 ID를 찾으세요.

information_search（정보 전문 검색）

1. 인공지능 관련 뉴스를 검색하고 제목과 출처만 보세요.

2. 신에너지차 정보를 검색하고 짧은 본문 두 개를 반환하세요.

information_company_news（기업 정보 조회）

1. 小米科技有限责任公司의 최근 기업 뉴스를 조회하세요.

2. 珠海格力电器股份有限公司의 부정 여론을 확인하세요.

information_industry_news（산업 정보 검색）

1. 저고도 경제 산업의 최신 정보를 검색하세요.

2. 휴머노이드 로봇 분야의 최근 산업 동향은 무엇인가요?

information_topic（정보 주제 추적）

1. 인공지능 대형 모델이라는 기술 주제를 지속적으로 추적하세요.

2. 소비재 교체 지원 정책 관련 이벤트를 추적하세요.

information_monitor（기업 정보 동향 모니터링）

1. 小米科技有限责任公司의 여론 감성 분포와 추세를 모니터링하세요.

2. 北京京东世纪贸易有限公司의 최신 정보 이벤트 상세를 확인하세요.

테스트 검증

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

단위 테스트는 Mock HTTP 응답을 사용하며 실제 HandaaS 정보 API를 호출하지 않습니다.