模型上下文协议 - Gemini思考服务器

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

概述

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

• 将复杂的问题分解成步骤
• 具有修订空间的规划和设计
• 可能需要调整方向的分析
• 初始范围可能不明确的问题

特性

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

安装

# 克隆仓库
git clone <repository-url>

# 安装依赖
npm install

# 构建项目
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": "我们如何设计一个可持续的城市交通系统？",
  "context": "这座城市有50万居民，目前严重依赖个人车辆。",
  "approach": "考虑环境、经济和社会因素。",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true
}

响应格式

服务器响应如下：

{
  "thought": "Gemini生成的思想",
  "thoughtNumber": 1,
  "totalThoughts": 5,
  "nextThoughtNeeded": true,
  "branches": [],
  "thoughtHistoryLength": 1,
  "metaComments": "关于推理的元评论",
  "confidenceLevel": 0.85,
  "alternativePaths": ["替代方法1", "替代方法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