Google-Scholar

Google-Scholar

An MCP server offering Google Scholar search via a streamable HTTP transport.

12
Stars
4
Forks
0
Releases

Overview

The Google Scholar MCP Server is a TypeScript-based MCP (Model Context Protocol) server built with the @modelcontextprotocol/sdk. It exposes Google Scholar search functionality through a streamable HTTP transport (StreamableHTTPServerTransport), enabling HTTP POST RPC-style interactions and HTTP GET SSE streams for real-time updates. The server uses a session-based architecture to support multiple simultaneous connections via unique session IDs, a pluggable Tool System for registering and executing tools, and robust error handling with JSON-RPC error responses. The primary tool currently exposed is search_google_scholar, which supports configurable search parameters (query, filters, etc.) and returns structured results with paper details. Transport capabilities include persistent connections and SSE-driven updates. The project demonstrates integration with AI models such as Google's Gemini via a client that discovers tools and performs function calling, enabling end-to-end chat workflows. The repository includes server and client components, a development outline, example usage, and guidance on adding new tools, configuring environment variables, and running the server on port 3000.

Details

Owner
mochow13
Language
TypeScript
License
Updated
2025-12-07

Features

Multi-session Support

Supports multiple clients simultaneously by managing distinct session IDs.

Graceful Shutdown

Ensures proper cleanup and resource release on SIGINT.

Logging

Provides comprehensive request/response logging for observability.

Error Handling

JSON-RPC compliant error responses with transport, tool, and client error handling.

Streamable HTTP Transport

Offers HTTP POST for requests and HTTP GET SSE streams with real-time updates.

Tool Registration and Execution Framework

An extensible system to register, manage, and execute MCP tools.

Google Scholar Search Tool (search_google_scholar)

Search Google Scholar and return structured results with paper details; supports configurable parameters.

Audience

AI developersBuild MCP servers with custom tools and integrate them with Gemini AI models.
System integratorsIntegrate the MCP server into larger AI workflows and client applications.
ResearchersExplore Google Scholar search via MCP tools for AI-assisted research workflows.

Tags

MCPGoogle ScholarStreamableHTTPServerTransportTypeScriptGeminiSSEHTTPTool SystemMulti-sessionJSON-RPC