버전 2.0이 나왔습니다!
뉴스 - 새로운 'KiCAD MCP 서버'가 출시되었습니다. 'Google 검색 MCP 서버'와 함께 이 둘은 강력한 듀오입니다!
https://github.com/mixelpixx/KiCAD-MCP-Server
Google 검색 MCP 서버
Google 검색 기능과 웹페이지 콘텐츠 분석 도구를 제공하는 MCP(Model Context Protocol) 서버입니다. 이 서버를 통해 AI 모델은 Google 검색을 수행하고 웹페이지 콘텐츠를 프로그래밍 방식으로 분석할 수 있습니다.
특징
- Google 맞춤 검색 통합
- 고급 검색 기능(필터, 정렬, 페이지 매김, 분류)
- 다양한 형식(마크다운, HTML, 일반 텍스트)으로 웹페이지 콘텐츠 분석
- 일괄 웹페이지 분석
- 결과 분류 및 분류
- 콘텐츠 요약
- 최적화된, 사람이 읽을 수 있는 응답
- MCP 호환 인터페이스
필수 조건
- Node.js(v16 이상)
- Google Cloud Platform 계정
- 사용자 정의 검색 엔진 ID
- 구글 API 키
설치
- 저장소를 복제합니다
- Node.js 종속성을 설치하세요.
지엑스피1
- TypeScript 코드를 작성합니다.
구성
- Google API 자격 증명에 대한 환경 변수를 설정하세요.
이를 시스템 환경 변수로 설정하거나 MCP 설정 파일에서 구성할 수 있습니다.
필수 환경 변수:
GOOGLE_API_KEY : Google API 키GOOGLE_SEARCH_ENGINE_ID : 사용자 지정 검색 엔진 ID
- MCP 설정 파일(일반적으로
%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에 위치)에 서버 구성을 추가합니다.
{
"mcpServers": {
"google-search": {
"autoApprove": [
"google_search",
"extract_webpage_content",
"extract_multiple_webpages"
],
"disabled": false,
"timeout": 60,
"command": "node",
"args": [
"/path/to/google-search-mcp-server/dist/google-search.js"
],
"env": {
"GOOGLE_API_KEY": "your-google-api-key",
"GOOGLE_SEARCH_ENGINE_ID": "your-custom-search-engine-id"
},
"transportType": "stdio"
}
}
}
달리기
MCP 서버를 시작합니다.
사용 가능한 도구
1. 구글 검색
Google에서 검색하면 웹에서 관련 결과를 보여줍니다. 이 도구는 Google 검색 엔진을 사용하여 특정 주제에 대한 웹 페이지, 기사 및 정보를 찾아줍니다.
{
"name": "google_search",
"arguments": {
"query": "your search query",
"num_results": 5, // optional, default: 5
"site": "example.com", // optional, limit results to specific website
"language": "en", // optional, filter by language (ISO 639-1 code)
"dateRestrict": "m6", // optional, filter by date (e.g., "m6" for last 6 months)
"exactTerms": "exact phrase", // optional, search for exact phrase
"resultType": "news", // optional, specify type (news, images, videos)
"page": 2, // optional, page number for pagination (starts at 1)
"resultsPerPage": 10, // optional, results per page (max: 10)
"sort": "date" // optional, sort by "date" or "relevance" (default)
}
}
응답에는 다음이 포함됩니다.
- 읽기 쉬운 형식으로 제목, 링크, 스니펫이 포함된 검색 결과
- 페이지 정보(현재 페이지, 전체 결과 등)
- 결과 카테고리(자동 감지)
- 페이지 매김에 대한 탐색 힌트
2. 웹페이지 콘텐츠 추출
웹페이지에서 콘텐츠를 추출하고 분석하여 읽을 수 있는 텍스트로 변환합니다. 이 도구는 광고, 탐색 요소 및 기타 불필요한 요소를 제거하면서 주요 콘텐츠를 가져옵니다.
{
"name": "extract_webpage_content",
"arguments": {
"url": "https://example.com",
"format": "markdown" // optional, format options: "markdown" (default), "html", or "text"
}
}
응답에는 다음이 포함됩니다.
- 웹페이지의 제목과 설명
- 콘텐츠 통계(단어 수, 문자 수)
- 콘텐츠 요약
- 콘텐츠 미리보기(처음 500자)
3. 여러 웹페이지 추출
한 번의 요청으로 여러 웹페이지의 콘텐츠를 추출하고 분석합니다. 다양한 출처의 정보를 비교하거나 특정 주제에 대한 포괄적인 정보를 수집하는 데 적합합니다.
{
"name": "extract_multiple_webpages",
"arguments": {
"urls": [
"https://example1.com",
"https://example2.com"
],
"format": "html" // optional, format options: "markdown" (default), "html", or "text"
}
}
응답에는 다음이 포함됩니다.
- 각 웹페이지의 제목과 설명
- 각 웹페이지의 콘텐츠 통계
- 각 웹페이지의 콘텐츠 요약
- 각 웹페이지의 콘텐츠 미리보기(처음 150자)
Google API 자격 증명 얻기
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- 사용자 정의 검색 API 활성화
- API 자격 증명(API 키) 생성
- 사용자 정의 검색 엔진 페이지로 이동
- 새로운 검색 엔진을 만들고 검색 엔진 ID를 얻으세요
- 이러한 자격 증명을 MCP 설정 파일에 추가하거나 환경 변수로 설정하세요.
오류 처리
서버는 다음에 대한 자세한 오류 메시지를 제공합니다.
- API 자격 증명이 누락되었거나 잘못되었습니다.
- 실패한 검색 요청
- 잘못된 웹페이지 URL
- 네트워크 연결 문제
건축학
이 서버는 TypeScript로 구축되었으며 MCP SDK를 사용하여 AI 모델이 Google 검색 및 웹페이지 콘텐츠 분석 도구와 상호 작용할 수 있는 표준화된 인터페이스를 제공합니다. 두 가지 주요 서비스로 구성됩니다.
- GoogleSearchService : 검색 기능을 위한 Google API 상호 작용을 처리합니다.
- ContentExtractor : 웹페이지 콘텐츠 분석 및 추출을 관리합니다.
서버는 캐싱 메커니즘을 사용하여 성능을 개선하고 API 호출을 줄입니다.
빌드된 버전 배포
소스 코드가 아닌, 이 도구의 빌드된 버전만 배포하려면 다음 단계를 따르세요.
- TypeScript 코드를 작성합니다.
- 필요한 파일만 포함하는 배포 패키지를 만듭니다.
# Create a distribution directory
mkdir -p dist-package
# Copy the compiled JavaScript files
cp -r dist dist-package/
# Copy package files (without dev dependencies)
cp package.json dist-package/
cp README.md dist-package/
# Create a simplified package.json for distribution
node -e "const pkg = require('./package.json'); delete pkg.devDependencies; delete pkg.scripts.build; delete pkg.scripts.dev; pkg.scripts.start = 'node dist/google-search.js'; require('fs').writeFileSync('dist-package/package.json', JSON.stringify(pkg, null, 2));"
- 그런 다음 사용자는 빌드된 버전을 설치하고 실행할 수 있습니다.
# Install production dependencies only
npm install --production
# Start the server
npm start
이 방법을 사용하면 TypeScript 소스 코드를 노출하지 않고 컴파일된 JavaScript 파일을 배포할 수 있습니다. 사용자는 여전히 다음 작업을 수행해야 합니다.
- Google API 자격 증명을 환경 변수로 구성합니다.
- MCP 설정 파일에 서버 구성을 추가합니다.
- 프로덕션 종속성 설치
배포판의 package.json에는 프로덕션 종속성과 단순화된 스크립트 세트만 포함됩니다.
특허
MIT