스트림 가능한 HTTP 전송을 통해 Google Scholar 검색 기능을 제공하는 모델 Context Protocol (MCP) 서버. 이 프로젝트는 MCP 서버를 맞춤 도구로 구축하고 Google의 Gemini와 같은 AI 모델과 통합하는 방법을 보여줍니다.

개요

이 프로젝트는 2개의 주요 성분으로 이루어져 있습니다:

• MCP Server: HTTP 엔드포인트를 통해 Google Scholar 검색 도구를 제공합니다.
• MCP Client: Google Gemini AI와 통합하여 쿼리 및 통화 도구

건축

MCP 서버 구현

서버는 @modelcontextprotocol/sdk을 사용하여 구축하고 구현합니다.

• Transport: HTTP 기반 통신을 위한 StreamableHTTPServerTransport
• Session Management: 세션 ID와 여러 동시 연결 지원
• Tool System: Extensible Tool 등록 및 실행 프레임 워크
• 처리: 포괄적인 오류 응답 및 로깅

사용 가능한 도구

서버는 현재 1개의 주요 도구를 제공합니다:

search_google_scholar

-Description: 학술 논문 및 연구에 대한 Google Scholar 검색 -Parameters: 설정 가능한 검색 매개 변수 (query, filter 등) -Returns: 종이 세부사항을 가진 구조상 검색 결과

Google Scholar MCP Server

A Model Context Protocol (MCP) server that provides Google Scholar search capabilities through a streamable HTTP transport. This project demonstrates how to build an MCP server with custom tools and integrate it with AI models like Google’s Gemini.

Overview

This project consists of two main components:

• MCP Server: Provides Google Scholar search tools via HTTP endpoints
• MCP Client: Integrates with Google Gemini AI to process queries and call tools

Architecture

MCP Server Implementation

The server is built using the @modelcontextprotocol/sdk and implements:

• Transport: StreamableHTTPServerTransport for HTTP-based communication
• Session Management: Supports multiple simultaneous connections with session IDs
• Tool System: Extensible tool registration and execution framework
• Error Handling: Comprehensive error responses and logging

Available Tools

The server currently provides one main tool:

search_google_scholar

• Description: Search Google Scholar for academic papers and research
• Parameters: Configurable search parameters (query, filters, etc.)
• Returns: Structured search results with paper details

Transport Protocol

The server uses StreamableHTTPServerTransport which supports:

• HTTP POST: For sending requests and receiving responses
• HTTP GET: For establishing Server-Sent Events (SSE) streams
• Session Management: Persistent connections with unique session IDs
• Real-time Notifications: Streaming updates via SSE

Smithery

The server is now available in Smithery: Google Scholar Search Server

Installation

Installing via Smithery

To install google-scholar-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @mochow13/google-scholar-mcp --client claude

1. Clone the repository:

git clone 
cd google-scholar-mcp

2. Install and build:

cd server
npm install
npm run build

cd client
npm install
npm run build

Running the Server

1. Start the MCP server:

cd server
node build/index.js

The server will start on port 3000 and provide the following endpoints:

• POST /mcp - Main MCP communication endpoint
• GET /mcp - SSE stream endpoint for real-time updates

Server Features

• Multi-session Support: Handle multiple clients simultaneously
• Graceful Shutdown: Proper cleanup on SIGINT
• Logging: Comprehensive request/response logging
• Error Handling: Structured JSON-RPC error responses

Running the Client

The client demonstrates how to integrate the MCP server with Google’s Gemini AI model.