Google News MCP Server

SerpAPI 통합을 통해 Google 뉴스 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 뉴스 결과를 자동으로 분류하고 여러 언어와 지역을 지원합니다.

https://github.com/user-attachments/assets/1cc71c27-f840-4c94-9ab5-460d84ba4779

✨ 특징

🔍 유연한 검색 옵션

쿼리 기반 검색, 주제 검색, 출판물 필터링 및 기사 보도를 포함한 포괄적인 검색 기능이 제공됩니다.

🌐 글로벌 커버리지

구성 가능한 언어 및 국가 코드를 통해 여러 언어와 지역을 지원합니다.

📊 스마트 분류

AI 및 기술, 비즈니스, 과학 및 연구, 의료 등의 주제별로 뉴스 결과를 자동으로 분류합니다.

🔀 여러 결과 유형

헤드라인, 스토리, 관련 주제, 메뉴 링크 등 다양한 뉴스 결과 유형을 처리합니다.

🛠️ 강력한 오류 처리

유용한 오류 메시지를 통해 API 오류 및 잘못된 입력에 대한 포괄적인 오류 처리를 제공합니다.

🌍 언어 지원

해당 사용자 알림과 함께 지원되지 않는 언어 코드의 경우 자동으로 영어로 대체됩니다.

🔑 SERP API 설정 가이드

시작하기 전에 SERP API 키를 받아야 합니다. 방법은 다음과 같습니다.

1. SERP API 웹사이트를 방문하여 계정을 만드세요
2. 등록 후 대시보드로 이동하세요.
   • "API 키" 섹션을 찾으세요
   • API 키를 복사하세요
   • 신규 사용자는 100개의 무료 API 호출을 받습니다.
3. API 사용 세부 정보:
   • 무료 계층: 월 100회 검색
   • 유료 플랜은 5000건 검색 시 월 50달러부터 시작됩니다.
   • 성공적인 API 호출에 따른 청구
   • 다양한 결제 방법: 신용카드, PayPal 등
4. 사용 제한:
   • 요청 속도: 초당 2개 요청
   • IP 제한: 없음
   • 동시 요청: 5개
   • 응답 캐시 시간: 1시간

👩‍🔧 NVM/NPM과 MCP 서버 연결 문제에 대한 솔루션

내 구성 솔루션을 보려면 클릭하세요 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 빠른 시작

1. 종속성 설치:

지엑스피1

2. 서버를 빌드하세요:

3. 환경 구성: 다음 내용으로 claude_desktop_config.json 을 수정합니다(시스템에 따라 경로를 조정하세요):

4. 서버를 시작합니다:

문제 해결

1. 잘못된 API 키

• claude_desktop_config.json 에서 API 키 구성을 확인하세요.
• SERP API 대시보드에서 API 키가 활성화되어 있는지 확인하세요.

2. 요청 실패

• 네트워크 연결 확인
• API 호출 할당량이 초과되지 않았는지 확인하세요.
• 요청 매개변수 형식 검증

실행 평가

evals 패키지는 index.ts 파일을 실행하는 mcp 클라이언트를 로드하므로 테스트 사이에 다시 빌드할 필요가 없습니다. npx 명령 앞에 접두사를 붙여 환경 변수를 로드할 수 있습니다. 전체 문서는 여기에서 확인할 수 있습니다.

📦 설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Google 뉴스를 자동으로 설치하는 방법:

mcp-get을 통해 설치

이전 버전의 Windows PowerShell을 사용하는 경우 이 명령을 실행하기 전에 Set-ExecutionPolicy Bypass -Scope Process 실행해야 할 수 있습니다.

수동 설치

@chanmeng666/구글 뉴스 서버

💻 기술 스택

📖 API 문서

서버는 모델 컨텍스트 프로토콜을 구현하고 다음 매개변수를 사용하여 Google 뉴스 검색 도구를 제공합니다.

• q : 검색 쿼리 문자열
• gl : 국가 코드(예: 'us', 'uk')
• hl : 언어 코드(예: 'en', 'es')
• topic_token : 특정 뉴스 주제에 대한 토큰
• publication_token : 특정 출판사를 위한 토큰
• story_token : 스토리의 전체 내용을 다루는 토큰
• section_token : 특정 섹션에 대한 토큰

🔧 개발

📝 라이센스

이 프로젝트는 MIT 라이센스를 받았습니다 .

🙋‍♀ 작가

Chan Meng 이 만들고 유지 관리합니다.