Google Patents MCP 서버( google-patents-mcp )
이 프로젝트는 SerpApi Google Patents API를 통해 Google Patents 정보를 검색할 수 있는 MCP(Model Context Protocol) 서버를 제공합니다.
변경 사항
v0.2.0 (2025년 4월 17일)
수정 사항:
resources/list및prompts/listMCP 메서드에 대한 빈 핸들러를 구현했습니다.수정: 서버 초기화 시
prompts기능을 선언했습니다.집안일: 종속성 업데이트.
이러한 변경 사항은 Claude Desktop과 같은 MCP 클라이언트와의 호환성을 개선하는 것을 목표로 하며, 이러한 클라이언트는 표준 엔드포인트를 필요로 할 수 있지만 Claude Desktop을 통한 직접 테스트는 아직 수행되지 않았습니다.
Related MCP server: MCP Server for Google Search
특징
Google Patents를 검색하기 위한 MCP 도구
search_patents제공합니다.백엔드로 SerpApi를 사용합니다.
로컬 설치 없이
npx사용하여 직접 실행할 수 있습니다.
필수 조건
Node.js: 버전 18 이상을 권장합니다.
npm:
npx명령을 실행하는 데 필요합니다.SerpApi API 키: Google Patents API를 사용하려면 SerpApi 의 유효한 API 키가 필요합니다.
빠른 시작(npx 사용)
이 서버를 실행하는 가장 쉬운 방법은 npx 사용하는 것입니다. 이 명령은 (필요한 경우) 서버를 직접 다운로드하고 실행합니다.
지엑스피1
참고: @kunihiros/google-patents-mcp 실제 게시된 패키지 이름으로 바꾸세요(다른 경우).
서버가 시작되어 표준 입출력에서 MCP 요청을 수신합니다.
구성
서버에는 SerpApi API 키가 필요합니다. 다음 방법 중 하나로 키를 제공하세요.
환경 변수(MCP 호스트 권장): 서버를 실행할 때
SERPAPI_API_KEY환경 변수를 설정하세요. MCP 호스트 구성에서 서버의 환경 변수를 설정할 수 있는 경우가 많습니다.MCP 호스트 구성 스니펫 예(
config.json또는 유사):{ "mcpServers": { "google-patents-mcp": { "command": "npx", "args": [ "-y", // Skips confirmation if the package isn't installed locally "@kunihiros/google-patents-mcp" // Use the correct package name ], "env": { "SERPAPI_API_KEY": "YOUR_ACTUAL_SERPAPI_KEY" // Optional: Set log level // "LOG_LEVEL": "debug" } } } }.env 파일:
npx명령을 실행하는 디렉토리(로컬 테스트용 또는 MCP 호스트를 사용하지 않는 경우) 또는 홈 디렉토리(~/.google-patents-mcp.env)에 다음 내용으로.env파일을 만듭니다.SERPAPI_API_KEY=YOUR_ACTUAL_SERPAPI_KEY # Optional: Set log level (e.g., debug, info, warn, error) # LOG_LEVEL=debug참고: 로컬 테스트에는
.env파일을 사용하는 것이 편리하지만, 프로덕션 환경이나 MCP 호스트와의 통합 환경에서는 호스트 구성을 통해 환경 변수를 직접 설정하는 것이 권장되고 더 안전한 방법입니다. 주요 사용 사례는npx통한 실행이며, 이 경우 환경 변수는 일반적으로 호출 프로세스 또는 MCP 호스트에서 관리됩니다.
서버는 다음 순서로 .env 파일을 검색합니다. * ./.env npx 실행되는 위치를 기준으로) * ~/.google-patents-mcp.env (홈 디렉토리에 있음)
MCP 도구 제공
search_patents
SerpApi를 통해 Google 특허를 검색합니다.
입력 스키마:
산출:
SerpApi의 검색 결과를 포함하는 JSON 객체를 반환합니다. 구조는 SerpApi 응답 형식을 따릅니다.
예시 사용(MCP 요청):
개발
(개발에 필요한 경우) 저장소를 복제합니다.
# git clone <repository-url> # cd google-patents-mcp종속성 설치:
npm install.env.env.example``.env로 복사하고SERPAPI_API_KEY추가합니다.짓다:
npm run build로컬로 실행:
npm start또는 자동 재빌드를 통한 개발의 경우:
npm run dev
벌채 반출
로그는 표준 오류로 출력됩니다.
로그 수준은
LOG_LEVEL환경 변수(error,warn,info,http,verbose,debug,silly)를 통해 제어할 수 있습니다. 기본값은info입니다.프로젝트 루트(
google-patents-server.log), 사용자 홈 디렉토리(~/.google-patents-server.log) 또는/tmp/google-patents-server.log에 로그 파일을 생성하려고 시도했습니다.
특허
MIT 라이센스(LICENSE 파일 참조)