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