自我mcp
认知支架平台，为人工智能代理提供持久的个性、记忆和情感。
ego-mcp是一个包含 MCP（模型上下文协议） 服务器，使LLM代理能够在会话中保持一致的个性、内存和情绪，以及用于实时可观察性的遥测仪表板。
主要特点
- 持久内存 --基于ChromaDB的语义搜索+Hopfield模式完成的联想回忆
- 抽象欲望系统 --内在动机的情绪/记忆调制非线性计算
- 认知支架 --工具响应包括思维框架，而不仅仅是数据，指导自然AI行为
- 关系模型 --构建与他人关系的心理理论框架
- 自我维护观念 --强化、衰减、重复合并、人物关联和相关概念链接
- 遥测仪表板 --工具使用、情绪趋势和日志的实时可视化
存储库结构
ego-mcp/
├── ego-mcp/ # MCP server (Python)
├── dashboard/ # Telemetry dashboard
│ ├── src/ # Backend (FastAPI + TimescaleDB + Redis)
│ └── frontend/ # Frontend (React + Vite + TypeScript)
├── design/ # Design documents
└── .github/workflows/ # CI自我mcp
MCP服务器为AI代理提供认知能力。
工具
曲面工具 --由代理人直接使用：
| 工具 | 说明 |
|---|---|
wake_up | 开始会话。返回上次内省+欲望总结 |
feel_desires | 通过行动指南检查当前的愿望水平 |
introspect | 获取反思材料：记忆、欲望、开放式问题 |
consider_them | 思考某人——心理理论框架 |
remember | 用情感和重要性保存记忆 |
recall | 按上下文回忆相关记忆 |
am_i_being_genuine | 真实性自检 |
后端工具 --在表面工具的指导下：
| 工具 | 说明 |
|---|---|
satisfy_desire | 将愿望标记为满足 |
consolidate | 运行内存整合 |
forget | 按ID删除内存 |
link_memories | 链接两个记忆 |
update_relationship | 更新关系模型 |
update_self | 更新自我模型 |
emotion_trend | 分析随时间变化的情绪模式 |
get_episode | 获取剧集详细信息 |
create_episode | 从记忆中创造情节 |
curate_notions | 列出、合并、重新标记或删除概念 |
设置
cd ego-mcp
uv sync --extra dev为嵌入提供程序设置环境变量：
# Gemini (default)
export GEMINI_API_KEY="your-gemini-api-key"
# OR OpenAI
export EGO_MCP_EMBEDDING_PROVIDER="openai"
export OPENAI_API_KEY="your-openai-api-key"跑
cd ego-mcp
uv run python -m ego_mcp连接到MCP客户端
Claude Desktop或其他MCP兼容客户端的示例配置：
{
"mcpServers": {
"ego": {
"command": "uv",
"args": ["run", "--directory", "/path/to/ego-mcp", "python", "-m", "ego_mcp"],
"env": {
"GEMINI_API_KEY": "your-key-here"
}
}
}
}看 ego-mcp/README.md 获取包括环境变量和工作区同步在内的完整文档。
仪表盘
遥测仪表板，用于观察自我mcp的动作。
- Now选项卡：总结卡+实时图表+事件提要
- “历史记录”选项卡：工具使用计数、概念维护历史、网络链接和参数趋势
- 日志选项卡：蒙面原木的活尾
运行（Docker编写）
cd dashboard
cp .env.example .env
# Memory Network / Notions も使う場合は ego-mcp の data dir を設定
# export DASHBOARD_EGO_MCP_DATA_DIR="/absolute/path/to/ego-mcp-data"
docker compose up --build- 后端：http://localhost:8000
- 前端：http://localhost:4173
看 仪表板/README.md 获取完整文档。
发展
先决条件
- Python 3.14
- 紫外线
- Node.js 24（仪表板前端）
- Docker+Docker Compose（仪表板）
测试与棉绒
# ego-mcp
cd ego-mcp
GEMINI_API_KEY=test-key uv run pytest tests -v
uv run ruff check src tests
uv run mypy src tests
# dashboard backend
cd dashboard
uv run pytest -v
uv run ruff check src tests
uv run mypy src tests
# dashboard frontend
cd dashboard/frontend
npm ci
npm run lint
npm run test
npm run build致谢
许可证
麻省理工学院