Model Context Protocol - Gemini Thinking Server

这是 Model Context Protocol (MCP) 的一个实现，它与 Google 的 Gemini API 集成，提供分析性思维能力而无需生成代码。

概述

Gemini 思维服务器是一个专门的 MCP 服务器，利用 Google 的 Gemini 模型来提供顺序思考和解决问题的能力。它允许：

• 将复杂问题分解为步骤
• 规划和设计，并留有修改空间
• 可能需要修正方向的分析
• 初始时可能不清楚全部范围的问题

功能

• Gemini 驱动的思维：利用 Gemini 的分析能力生成深思熟虑的回应
• 元评论：提供对推理过程的见解
• 置信水平：指示 Gemini 对其分析的信心程度
• 替代路径：提出解决问题的不同方法
• 分支思维：允许探索不同的思维路径
• 修订功能：支持修订之前的思维
• 会话持久化：保存和恢复分析会话

安装

# Clone the repository
git clone <repository-url>

# Install dependencies
npm install

# Build the project
npm run build

使用

环境设置

在运行服务器之前，您需要设置您的 Gemini API 密钥：

export GEMINI_API_KEY=your_api_key_here

运行服务器

node dist/gemini-index.js

工具参数

geminithinking 工具接受以下参数：

• query（必需）：要分析的问题或难题
• context（可选）：额外的上下文信息
• approach（可选）：建议的问题解决方法
• previousThoughts（可选）：用于上下文的先前思维数组
• thought（可选）：您当前的思维步骤（如果为空，将由 Gemini 生成）
• nextThoughtNeeded（必需）：是否需要另一个思维步骤
• thoughtNumber（必需）：当前思维编号
• totalThoughts（必需）：估计所需的总思维数量
• isRevision（可选）：这是否是修订之前的思维
• revisesThought（可选）：正在重新考虑哪个思维
• branchFromThought（可选）：分支点思维编号
• branchId（可选）：分支标识符
• needsMoreThoughts（可选）：是否需要更多思维

会话管理

该工具还支持会话管理命令：

• sessionCommand：管理会话的命令（'save', 'load', 'getState'）
• sessionPath：保存或加载会话文件的路径（对于'save' 和 'load' 命令是必需的）

示例：保存会话

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

示例：加载会话

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

示例：获取会话状态

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

示例

以下是使用该工具的一个示例：

{
  "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
}

响应格式

服务器响应如下：

{
  "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"]
}

示例客户端

提供了几个示例客户端来演示不同的用例：

• sample-client.js: 基本客户端示例
• example-usage.js: 具体使用示例
• codebase-analysis-example.js: 代码库分析示例
• session-example.js: 会话持久性示例
• advanced-filtering-example.js: 高级语义过滤示例

要运行会话示例：

node dist/session-example.js

要运行高级过滤示例：

node dist/advanced-filtering-example.js

许可证

MIT