☀️ Helios MCP☀️
以数学精度将无状态AI转化为不断进化的个性
🚀 赫利俄斯是什么？
Helios是一个配置持久化引擎，通过加权行为继承为AI代理提供长期记忆和不断进化的个性。与检索知识的RAG系统不同，Helios管理 如何 你的AI行为，而不是 什么 它知道。
它解决的问题
今天的每一次人工智能对话都是从零开始的。你反复解释你的偏好、工作风格和背景。你的人工智能助手不记得你是谁，也不知道你喜欢如何工作。 赫利俄斯改变了这一点。
解决方案
Helios为AI人格进化提供了一个数学框架：
- 基本配置 定义核心行为（70%的影响力）
- 专业角色 适应特定环境（30%的影响）
- 学习系统 从实际使用中捕捉模式
- Git版本控制 跟踪每一个行为变化
这不是快速工程，而是个性工程。
⚡ 安装和设置
🚀 快速安装（30秒）
# One command to rule them all
uvx helios-mcp就是这样！Helios现在可以作为MCP服务器使用。
📱 IDE集成
✨ Cursor (Recommended)
增添 ~/.cursor/mcp.json:
{
"mcpServers": {
"helios": {
"command": "uvx",
"args": ["helios-mcp", "--helios-dir", "~/.helios"]
}
}
}🔵 Claude Desktop
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"helios": {
"command": "uvx",
"args": ["helios-mcp", "--helios-dir", "~/.helios"]
}
}
}💻 VS Code / Claude Code
添加到您的VS代码 settings.json:
{
"mcp.servers": {
"helios": {
"command": "uvx",
"args": ["helios-mcp"]
}
}
}🌊 Windsurf
添加到您的Windsurf MCP配置中：
{
"mcpServers": {
"helios": {
"command": "uvx",
"args": ["helios-mcp", "--helios-dir", "~/.helios"]
}
}
}🔧 Development Setup
对于贡献者和当地发展：
# Clone and setup
git clone https://github.com/akougkas/helios-mcp
cd helios-mcp
uv sync
# Run locally
uv run helios-mcp --verbose🎯 首次设置
安装后，创建您的第一个角色：
# Helios will create ~/.helios/ automatically on first run
mkdir -p ~/.helios/personas创建 ~/.helios/personas/developer.yaml:
specialization_level: 2
behaviors:
communication_style: "Concise with code examples"
problem_solving: "Test-driven, iterative"
preferred_tools: ["pytest", "uv", "ruff"]🎉 完成！ 你的AI现在拥有持久的记忆和个性。
✨ 特性
🧬 加权继承模型
# The core formula that powers Helios
inheritance_weight = base_importance / (specialization_level ** 2)
final_behavior = base * inheritance_weight + persona * (1 - inheritance_weight)🎯 多角色支持
- 开发者：技术、测试驱动、喜欢干净的代码
- 研究员：学术性、以引文为中心、有条不紊
- 创意：富有想象力、叙事驱动、实验性
- 自定义：定义你需要的任何个性
📊 Git驱动内存
- 每次配置更改都会进行版本控制
- 回滚到任何以前的个性状态
- 追踪行为随时间的演变
- 协作角色开发
🔧 MCP本地
专为模型上下文协议而构建，具有11个强大的工具，用于AI代理管理自己的进化（7个核心+4个学习）。
📚 文档
______________________________________________________________________
🤖 AI代理集成指南
*本节提供了使用Helios MCP的AI代理的详细技术信息。*
可用的MCP工具
Helios通过模型上下文协议公开了11个工具（7个核心+4个学习）：
| 工具 | 参数 | 返回 | 目的 |
|---|---|---|---|
get_base_config | 没有 | {base_importance: float, behaviors: dict} | 荷载基础配置 |
get_active_persona | name: str | {specialization_level: int, behaviors: dict} | 检索角色配置 |
merge_behaviors | base: dict, persona: dict | {merged: dict, weights: dict} | 计算继承 |
list_personas | 没有 | [{name: str, level: int}] | 列出可用人物角色 |
update_preference | path: str, value: any | {success: bool} | 修改配置 |
search_patterns | confidence: float | [{pattern: str, score: float}] | 发现习得的行为 |
commit_changes | message: str | {commit_id: str} | 版本更改 |
| 学习工具 | |||
learn_behavior | persona: str, key: str, value: any | {old_value, new_value} | 添加/更新行为 |
tune_weight | target: str, parameter: str, value: float | {old_value, new_value} | 调整重量 |
revert_learning | commits_back: int | {reverted_commits} | 通过git撤销 |
evolve_behavior | from: str, to: str, key: str | {direction, value} | 迁移行为 |
学习系统
直接编辑配置的学习工具：
learn_behavior(persona, key, value)-添加/更新行为tune_weight(target, parameter, value)-调整继承权重revert_learning(commits_back)-通过git撤销最近的学习evolve_behavior(from, to, key)-促进配置之间的行为
所有学习都通过git进行跟踪，提供完整的历史记录和回滚功能。
______________________________________________________________________
💡 用例
现实世界场景
软件开发团队
- 上午：加载系统设计的“架构师”角色
- 下午：切换到“调试器”进行故障排除
- 代码审查：使用“导师”角色进行教学
研究与写作
- 文献综述：“研究者”人格
- 数据分析：“统计学家”角色
- 论文写作：“学术作家”人格
个人助理
- 工作时间：专业、正式沟通
- 个人时间：随意、友好的互动
- 学习模式：耐心，教育方式
🛠️ 发展
# Clone and setup
git clone https://github.com/akougkas/helios-mcp
cd helios-mcp
uv sync
# Run tests (159 tests passing)
uv run pytest
# Run with local changes
uv run helios-mcp --verbose技术栈
- Python 3.13 使用JIT编译器
- FastMCP 2.2.6+ 用于MCP协议
- 紫外线的 用于依赖关系管理
- Git 用于版本控制
- 格式 对于配置
🐛 故障排除
Common Issues & Solutions
| 问题 | 解决方案 | |
|---|---|---|
uvx: command not found | 安装紫外线： `curl -LsSf https://astral.sh/uv/install.sh \ | sh` |
No personas found | 创建 ~/.helios/personas/default.yaml | |
Permission denied | 检查写入权限： ls -la ~/.helios/ | |
Git initialization failed | 快跑 git init 在……里面 ~/.helios/ | |
MCP connection failed | 更改配置后重新启动IDE | |
Tool not found | 快跑 uvx helios-mcp 或检查路径 |
调试命令：
# Verify installation
uvx helios-mcp --version
# Test with verbose logging
uvx helios-mcp --verbose
# Check your personas
ls -la ~/.helios/personas/
# Validate YAML syntax
uv run python -c "import yaml; yaml.safe_load(open('~/.helios/base/identity.yaml'))"还有问题吗？
🌟 社区与支持
🤝 贡献
我们欢迎捐款！看 贡献.md 作为指导方针。
快速贡献
# Fork, clone, branch
git checkout -b feature/your-feature
# Make changes, test
uv run pytest
# Submit PR
gh pr create📄 许可证
麻省理工学院©2025安东尼·库卡斯
🙏 致谢
为 模型上下文协议 生态系统。特别感谢MCP社区和早期采用者。
______________________________________________________________________
将您的AI从无状态转变为复杂
uvx helios-mcp内置于☀️ 由人类，为AI