Gemini Thinking Server

Model Context Protocol - Gemini Thinking Server

This is an implementation of the Model Context Protocol (MCP) that integrates with Google's Gemini API to provide analytical thinking capabilities without code generation.

Overview

The Gemini Thinking Server is a specialized MCP server that leverages Google's Gemini model to provide sequential thinking and problem-solving capabilities. It allows for:

Breaking down complex problems into steps
Planning and design with room for revision
Analysis that might need course correction
Problems where the full scope might not be clear initially

Features

Gemini-Powered Thinking: Utilizes Gemini's analytical capabilities to generate thoughtful responses
Meta-Commentary: Provides insights into the reasoning process
Confidence Levels: Indicates how confident Gemini is in its analysis
Alternative Paths: Suggests different approaches to the problem
Branching Thoughts: Allows exploration of different thought paths
Revision Capability: Supports revising previous thoughts
Session Persistence: Save and resume analysis sessions

Installation

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

# Build the project
npm run build

Usage

Environment Setup

Before running the server, you need to set up your Gemini API key:

export GEMINI_API_KEY=your_api_key_here

Running the Server

node dist/gemini-index.js

Tool Parameters

The geminithinking tool accepts the following parameters:

query (required): The question or problem to analyze
context (optional): Additional context information
approach (optional): Suggested approach to the problem
previousThoughts (optional): Array of previous thoughts for context
thought (optional): Your current thinking step (if empty, will be generated by Gemini)
nextThoughtNeeded (required): Whether another thought step is needed
thoughtNumber (required): Current thought number
totalThoughts (required): Estimated total thoughts needed
isRevision (optional): Whether this revises previous thinking
revisesThought (optional): Which thought is being reconsidered
branchFromThought (optional): Branching point thought number
branchId (optional): Branch identifier
needsMoreThoughts (optional): If more thoughts are needed

Session Management

The tool also supports session management commands:

sessionCommand: Command to manage sessions ('save', 'load', 'getState')
sessionPath: Path to save or load the session file (required for 'save' and 'load' commands)

Example: Saving a Session

{
  "sessionCommand": "save",
  "sessionPath": "/path/to/save/session.json",
  "query": "dummy",
  "thoughtNumber": 1,
  "totalThoughts": 1,
  "nextThoughtNeeded": false
}

Example: Loading a Session

{
  "sessionCommand": "load",
  "sessionPath": "/path/to/load/session.json",
  "query": "dummy",
  "thoughtNumber": 1,
  "totalThoughts": 1,
  "nextThoughtNeeded": false
}

Example: Getting Session State

{
  "sessionCommand": "getState",
  "query": "dummy",
  "thoughtNumber": 1,
  "totalThoughts": 1,
  "nextThoughtNeeded": false
}

Example

Here's an example of how to use the tool:

{
  "query": "How might we design a sustainable urban transportation system?",
  "context": "The city has 500,000 residents and currently relies heavily on personal vehicles.",
  "approach": "Consider environmental, economic, and social factors.",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true
}

Response Format

The server responds with:

{
  "thought": "The generated thought from Gemini",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true,
  "branches": [],
  "thoughtHistoryLength": 1,
  "metaComments": "Meta-commentary about the reasoning",
  "confidenceLevel": 0.85,
  "alternativePaths": ["Alternative approach 1", "Alternative approach 2"]
}

Example Clients

Several example clients are provided to demonstrate different use cases:

sample-client.js: Basic client example
example-usage.js: Specific usage example
codebase-analysis-example.js: Example for codebase analysis
session-example.js: Example demonstrating session persistence
advanced-filtering-example.js: Example demonstrating advanced semantic filtering

To run the session example:

node dist/session-example.js

To run the advanced filtering example:

node dist/advanced-filtering-example.js

License

MIT

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

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.

Tools

geminithinking

An MCP server implementation that leverages Google's Gemini API to provide analytical problem-solving capabilities through sequential thinking steps without code generation.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Sequential Thinking MCP Server
arben-adm
A
security
A
license
A
quality
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.
Last updated -
3
90
Python
MIT License
mcp-sequentialthinking-tools
spences10
A
security
A
license
A
quality
An adaptation of the MCP Sequential Thinking Server designed to guide tool usage in problem-solving. This server helps break down complex problems into manageable steps and provides recommendations for which MCP tools would be most effective at each stage.
Last updated -
1
434
148
TypeScript
MIT License
Gemini MCP Server
palolxx
-
security
-
license
-
quality
An MCP server implementation that allows using Google's Gemini AI models (specifically Gemini 1.5 Pro) through Claude or other MCP clients via the Model Context Protocol.
Last updated -
1
JavaScript
Yellhorn MCP
msnidal
A
security
F
license
A
quality
An MCP server that connects Gemini 2.5 Pro to Claude Code, enabling users to generate detailed implementation plans based on their codebase and receive feedback on code changes.
Last updated -
2
3
Python

View all related MCP servers