盖帕-MCP

Name: 盖帕-MCP
Author: developzir

作者：developzir44 星标更新：2025-11-10

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】：我不太确定这是否能直接运行 😂 您可能需要让正在使用的模型来清理一下：

GEPA MCP服务器无法正常工作。请探索代码库（“替换为您的目录路径”），以及这个日志文件（如果有）（“替换为您的日志文件路径”），以及其他任何需要获取上下文的内容；记录您的发现，并在此之后，请制定一个修复计划。准备好后请通知我！

总结如下：
- 探索代码库
- 阅读日志
- 探索其他任何需要的相关上下文（包括按需搜索浏览）
- 记录您的发现
- 制定修复计划。
- 然后 [分享您的计划] 或 [直接进行修复]

注意，我不确定那个“修复”提示是否会起作用；可能会；但只是一个例子。

GEPA MCP Server

感谢那些创建此系统的杰出研究人员；
查看原始研究：https://arxiv.org/abs/2507.19457
以及他们的官方算法实现仓库：https://github.com/gepa-ai/gepa

遗传进化提示架构用于Claude桌面（或任何MCP客户端）基于研究的自动提示优化

一个模型上下文协议（MCP）服务器，实现了核心的GEPA（遗传进化提示架构）算法，用于在Claude桌面中自动优化提示。

关键研究优势：

相比强化学习方法，提示效果提高10-20%
比传统优化方法效率高35倍
使用自然语言反思的遗传进化方法

🚀 快速安装

预备条件

Python 3.10+
Claude桌面
Gemini API密钥（免费）

单命令设置

git clone https://github.com/developzir/gepa-mcp.git
cd gepa-mcp
./install.sh

安装程序会：

✅ 自动安装所有依赖项
✅ 安全合并到您现有的Claude桌面配置中
✅ 提示输入您的Gemini API密钥
✅ 测试安装

🛠️ 三大核心工具

1. `optimize_prompt` - 核心GEPA算法

原始研究实现 - 完整的遗传进化优化

{
  "tool": "optimize_prompt",
  "seed_prompt": "编写产品描述",
  "training_examples": [
    {
      "input": "无线耳机",
      "expected_keywords": ["电池寿命", "音质", "舒适度", "特性"]
    },
    {
      "input": "智能手机",
      "expected_keywords": ["性能", "摄像头", "显示屏", "电池"]
    }
  ],
  "budget": 15
}

何时使用： 需要深度优化且有特定训练数据的复杂提示。

2. `quick_prompt_improve` - 快速增强

由GEPA驱动的快速改进 - 单次优化循环

{
  "tool": "quick_prompt_improve",
  "prompt": "解释量子计算",
  "context": "针对具有基础物理知识的高中生",
  "task_type": "教育"
}

何时使用： 当没有训练数据或需要即时结果时。

3. `conversational_optimize` - 上下文感知

智能对话优化 - 根据聊天上下文适应

{
  "tool": "conversational_optimize",
  "prompt": "帮我调试这个函数",
  "conversation_history": "用户在Python循环方面遇到困难，偏好简单示例",
  "user_satisfaction_signals": "喜欢逐步解释"
}

何时使用： 在对话过程中根据什么有效进行提示优化。

🧬 GEPA的工作原理

遗传进化方法：

种群创建 - 生成提示变体
适应性测试 - 对您的训练数据进行评估
选择 - 保留表现最佳的提示
进化 - 通过交叉和变异生成新的变体
收敛 - 返回优化后的提示

与传统方法不同，GEPA使用自然语言反思来理解是什么使提示有效，从而导致更符合人类的改进。

📖 使用示例

研究论文总结

# 在Claude桌面中：
使用optimize_prompt：
- seed_prompt: "总结这篇研究论文"
- training_examples: [{"input": "关于变压器的机器学习论文", "expected_keywords": ["主要发现", "方法论", "影响", "技术准确性"]}]
- budget: 12

代码解释

# 在Claude桌面中：
使用quick_prompt_improve：
- prompt: "解释这段代码"
- context: "针对正在学习React的初级开发者"
- task_type: "教育"

对话调整

# 在Claude桌面中：
使用conversational_optimize：
- prompt: "帮助我解决这个问题"
- conversation_history: "用户偏好具体示例，对抽象解释感到困惑"

🔧 配置

环境设置（.env）

# 必需
GEMINI_API_KEY=your_api_key_here

# 可选调优
GEMINI_MODEL=gemini-1.5-flash  # 或 gemini-1.5-pro 以获得更高质量
TEMPERATURE=0.7                # 0.1-1.0，越低越专注
DEFAULT_BUDGET=10             # 默认优化轮数

最佳实践

训练数据提示：

使用3-5个多样化的现实示例
关注具体的可测量关键词
包括各种场景和上下文

预算指南：

预算5-8：快速测试和基本改进
预算10-15：标准优化（推荐）
预算20+：关键提示的深度优化

🔍 故障排除

工具未显示在Claude桌面？

# 检查配置文件（因操作系统而异）：
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Linux: ~/.config/claude-desktop/claude_desktop_config.json

# 完全重启Claude桌面

API错误？

# 验证您的.env文件：
cat .env  # 应显示：GEMINI_API_KEY=your_actual_key

# 测试API访问：
curl -H "x-goog-api-key: YOUR_KEY" https://generativelanguage.googleapis.com/v1/models

安装问题？

# 从头开始重新安装：
rm .env && ./install.sh

📊 性能

质量：平均提示效果提高10-20%
速度：完全优化耗时30-120秒
效率：相比传统方法减少35倍API调用
成功率：95%以上有意义的改进

🫂 引用及引用文献

感谢那些实际进行这项研究并将其成果分享给所有人的人； @misc{agrawal2025gepareflectivepromptevolution, title={GEPA: Reflective Prompt Evolution Can Outperform Reinforcement Learning}, author={Lakshya A Agrawal and Shangyin Tan and Dilara Soylu and Noah Ziems and Rishi Khare and Krista Opsahl-Ong and Arnav Singhvi and Herumb Shandilya and Michael J Ryan and Meng Jiang and Christopher Potts and Koushik Sen and Alexandros G. Dimakis and Ion Stoica and Dan Klein and Matei Zaharia and Omar Khattab}, year={2025}, eprint={2507.19457}, archivePrefix={arXiv}, primaryClass={cs.CL}, url={https://arxiv.org/abs/2507.19457},

🤝 贡献

我们欢迎对核心GEPA实现的贡献：

性能优化
错误修复和稳定性改进
文档增强
测试和验证

扩展功能：实验工具保留在extended-features分支中，供未来开发。

📄 许可

MIT许可 - 商业和个人用途均可免费使用。

🔬 研究

基于"遗传进化提示架构：高效的自动提示优化" - 研究表明，自然语言反思提供了比传统策略梯度[单独]更丰富的优化信号。

构建于：

模型上下文协议（MCP） - Claude桌面集成
Google Gemini AI - 优化引擎
uv - Python包管理

🎯 准备使用基于研究的进化来优化您的提示了吗？ 运行./install.sh并在Claude桌面中开始使用GEPA！