Skip to main content
Glama
enesjakozh
bartekke8it56w2

Gemini Thinking Server

by bartekke8it56w2
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: gpal

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

Available Tools

1 tool
geminithinkingA

A detailed tool for dynamic and reflective problem-solving through Gemini AI. This tool helps analyze problems through a flexible thinking process powered by Google's Gemini model. Each thought can build on, question, or revise previous insights as understanding deepens.

When to use this tool:

  • 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

  • Problems that require a multi-step solution

  • Tasks that need to maintain context over multiple steps

  • Situations where irrelevant information needs to be filtered out

Key features:

  • Leverages Gemini AI for deep analytical thinking

  • Provides meta-commentary on the reasoning process

  • Indicates confidence levels for generated thoughts

  • Suggests alternative approaches when relevant

  • You can adjust total_thoughts up or down as you progress

  • You can question or revise previous thoughts

  • You can add more thoughts even after reaching what seemed like the end

  • You can express uncertainty and explore alternative approaches

  • Not every thought needs to build linearly - you can branch or backtrack

  • Session persistence: save and resume your analysis sessions

Parameters explained:

  • query: The question or problem to be analyzed

  • context: Additional context information (e.g., code snippets, background)

  • approach: Suggested approach to the problem (optional)

  • previousThoughts: Array of previous thoughts for context

  • thought: The current thinking step (if empty, will be generated by Gemini)

  • next_thought_needed: True if you need more thinking, even if at what seemed like the end

  • thought_number: Current number in sequence (can go beyond initial total if needed)

  • total_thoughts: Current estimate of thoughts needed (can be adjusted up/down)

  • is_revision: A boolean indicating if this thought revises previous thinking

  • revises_thought: If is_revision is true, which thought number is being reconsidered

  • branch_from_thought: If branching, which thought number is the branching point

  • branch_id: Identifier for the current branch (if any)

  • needs_more_thoughts: If reaching end but realizing more thoughts needed

  • metaComments: Meta-commentary from Gemini about its reasoning process

  • confidenceLevel: Gemini's confidence in the generated thought (0-1)

  • alternativePaths: Alternative approaches suggested by Gemini

Session commands:

  • sessionCommand: Command to manage sessions ('save', 'load', 'getState')

  • sessionPath: Path to save or load the session file (required for 'save' and 'load' commands)

You should:

  1. Start with a clear query and any relevant context

  2. Let Gemini generate thoughts by not providing the 'thought' parameter

  3. Review the generated thoughts and meta-commentary

  4. Feel free to revise or branch thoughts as needed

  5. Consider alternative paths suggested by Gemini

  6. Only set next_thought_needed to false when truly done

  7. Use session commands to save your progress and resume later

ParametersJSON Schema
NameRequiredDescriptionDefault
queryYesThe question or problem to analyze
contextNoAdditional context information
thoughtNoYour current thinking step (if empty, will be generated by Gemini)
approachNoSuggested approach to the problem
branchIdNoBranch identifier
isRevisionNoWhether this revises previous thinking
sessionPathNoPath to save or load the session file
metaCommentsNoMeta-commentary about the reasoning process
thoughtNumberYesCurrent thought number
totalThoughtsYesEstimated total thoughts needed
revisesThoughtNoWhich thought is being reconsidered
sessionCommandNoCommand to manage sessions ('save', 'load', 'getState')
confidenceLevelNoConfidence level in the generated thought (0-1)
alternativePathsNoAlternative approaches suggested
previousThoughtsNoArray of previous thoughts for context
branchFromThoughtNoBranching point thought number
needsMoreThoughtsNoIf more thoughts are needed
nextThoughtNeededYesWhether another thought step is needed

TDQS

A3.8/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description fully covers behavioral aspects like meta-commentary, confidence levels, revision, branching, and session persistence. However, it omits potential costs or rate limits associated with the Gemini AI backend, slightly reducing transparency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-organized with sections and bullet points, but it is overly verbose. Some redundancy exists between the 'when to use' list and 'key features'. Removing repetition would improve conciseness while retaining clarity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity and lack of output schema, the description adequately explains usage flow and available actions. However, it does not explicitly specify the output structure (e.g., JSON containing generated thought, meta-comments, etc.), leaving minor ambiguity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3. The description adds extra context beyond schema descriptions, e.g., explaining that an empty 'thought' parameter will be AI-generated and that 'thought_number' can exceed initial estimates. This adds meaningful value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool is for dynamic, reflective problem-solving via Gemini AI. It includes specific usage scenarios and features. However, with no sibling tools, differentiation is not assessed, but the purpose is clear and distinct from a generic 'think' tool.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a detailed list of when to use the tool, including breaking down complex problems, planning, and analysis needing course correction. It does not explicitly mention when not to use it, but the extensive positive guidance compensates.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.1
    • First observedgeminithinking
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

A4/5.0
Disambiguation5/5

Only one tool exists, so there is no risk of confusion or overlap with other tools.

Naming Consistency5/5

With a single tool, naming consistency is inherently perfect; the name 'geminithinking' clearly describes its purpose.

Tool Count3/5

The server has only one tool, which feels thin for a domain that could benefit from separate tools for sessions, branching, or analysis management. However, the single tool is feature-rich.

Completeness5/5

The tool covers all expected functionalities for a deep thinking assistant: querying, context, revisions, branching, session persistence, and meta-commentary. No obvious gaps.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • Sequential-Thinking

    xiaobenyang-com
    A
    license
    A
    quality
    D
    maintenance
    A MCP server that implements sequential thinking protocols, provides structured problem-solving methods, decomposes complex problems into manageable steps, and supports iterative optimization and alternative reasoning paths.
    1
    2
    Apache 2.0

  • gpal

    tobert
    A
    license
    A
    quality
    D
    maintenance
    An MCP server that gives your IDE or agent access to Google Gemini with autonomous codebase exploration, enabling deep code analysis, architectural reviews, and bug hunting.
    20
    10
    MIT

  • Gemini Agent MCP Server

    cybaea
    A
    license
    A
    quality
    C
    maintenance
    An advanced MCP server that provides an agentic interface to Google's Gemini 3.1 models via Vertex AI, combining real-time Google Search, URL analysis, and Python code execution to solve complex multi-step research and data tasks.
    1
    MIT

Appeared in Searches

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bartekke8it56w2/new-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server