remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Enables web search capabilities through Google's Custom Search API, allowing users to retrieve search results with titles, URLs, and descriptions.
Uses Google Cloud's Custom Search API to perform web searches with configurable results (up to 10 per query).

MCP Google 맞춤 검색 서버

Google의 맞춤 검색 API를 통해 웹 검색 기능을 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 언어 학습 모델(LLM)은 표준화된 인터페이스를 사용하여 웹 검색을 수행할 수 있습니다.

🌟 특징

Google 맞춤 검색 API와의 원활한 통합
MCP(Model Context Protocol) 호환 서버 구현
TypeScript를 사용한 유형 안전 구현
환경 변수 구성
Zod를 사용한 입력 검증
구성 가능한 검색 결과(쿼리당 최대 10개)
제목, URL, 설명을 포함한 형식화된 검색 결과
오류 처리 및 검증
Claude Desktop 및 기타 MCP 클라이언트와 호환 가능

📋 필수 조건

시작하기 전에 다음 사항을 확인하세요.

사용자 지정 검색 API가 활성화된 Google Cloud 프로젝트
- Google Cloud Console 방문
- 사용자 정의 검색 API 활성화
- API 자격 증명 만들기
사용자 정의 검색 엔진 ID
- 프로그래밍 가능 검색 엔진 방문
- 새로운 검색 엔진 만들기
- 검색 엔진 ID를 받으세요
지역 개발 요구 사항:
- Node.js(v18 이상)
- npm(Node.js와 함께 제공)

🚀 빠른 시작

저장소를 복제합니다.지엑스피1
종속성 설치:
npm install
.env 파일을 만듭니다.
GOOGLE_API_KEY=your-api-key GOOGLE_SEARCH_ENGINE_ID=your-search-engine-id
서버를 빌드하세요:
npm run build
서버를 시작합니다:
npm start

🔧 구성

환경 변수

변하기 쉬운	설명	필수의
구글 API 키	Google 맞춤 검색 API 키	예
구글 검색 엔진 ID	사용자 정의 검색 엔진 ID	예

Claude 데스크톱 통합

Claude Desktop 구성 파일(일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 위치)에 다음 구성을 추가합니다.

{
  "mcpServers": {
    "google-search": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-google-custom-search-server/build/index.js"
      ],
      "env": {
        "GOOGLE_API_KEY": "your-api-key",
        "GOOGLE_SEARCH_ENGINE_ID": "your-search-engine-id"
      }
    }
  }
}

📖 API 참조

사용 가능한 도구

찾다

Google 맞춤 검색 API를 사용하여 웹 검색을 수행합니다.

매개변수:

query (문자열, 필수): 실행할 검색 쿼리
numResults (숫자, 선택 사항): 반환할 결과 수
- 기본값: 5
- 최대: 10

응답 예시:

Result 1:
Title: Example Search Result
URL: https://example.com
Description: This is an example search result description
---

Result 2:
...

🛠️ 개발

프로젝트 구조

mcp-google-custom-search-server/
├── src/
│   └── index.ts          # Main server implementation
├── build/                # Compiled JavaScript output
├── .env                  # Environment variables
├── package.json          # Project dependencies and scripts
├── tsconfig.json         # TypeScript configuration
└── README.md            # Project documentation

사용 가능한 스크립트

npm run build : TypeScript를 JavaScript로 컴파일
npm start : MCP 서버 시작
npm run dev : 개발을 위한 감시 모드

테스트

MCP Inspector 사용:
npx @modelcontextprotocol/inspector node build/index.js
예제 쿼리를 사용한 수동 테스트:
# After starting the server {"jsonrpc":"2.0","id":1,"method":"callTool","params":{"name":"search","arguments":{"query":"example search"}}}

📝 라이센스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

🙏 감사의 말

모델 컨텍스트 프로토콜(MCP) 로 구축됨
Google의 맞춤 검색 API를 사용합니다
LLM 애플리케이션에서 더 나은 검색 기능에 대한 필요성에서 영감을 얻었습니다.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

search

LLM이 표준화된 인터페이스를 통해 Google의 사용자 지정 검색 API를 사용하여 웹 검색을 수행할 수 있도록 하는 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

MCP Google Custom Search Server