agentcortex-mcp

# AgentCortex MCP 客户端 [](https://www.npmjs.com/package/agentcortex) [](https://opensource.org/licenses/MIT) [](https://github.com/sage-hq/agentcortex) > 🎯 **唯一解决上下文切换问题的 AI 记忆系统** > > 在项目之间切换时永远不会丢失上下文。AgentCortex 为每个代码库创建隔离的、持久的记忆库，以便您的 AI 助手记住所有内容 - 正確地放在它所属的位置。 ## 🔥 AgentCortex 改变一切的原因 **问题**：AI 助手在对话之间会忘记所有内容。更糟糕的是，当您处理多个项目时，上下文会混淆 - 您的 React 模式会污染您在项目 B 上使用 Vue.js 的工作。 **解决方案**：**项目隔离的持久记忆**。每个项目都有自己的智能记忆库，随着时间的推移变得更加智能，永远不会干扰您其他的工作。 ## ✨ 核心功能 ### 🎯 **项目上下文分离** *(游戏规则改变者)* - **每个项目/代码库的独立记忆库** - **不同仓库之间零上下文混淆** - **自动项目检测** 和上下文切换 - **每个新项目都有一张干净的画布**，**现有项目拥有完整的记忆** ### 🧠 **持久的跨会话记忆** - **在所有对话中永远不会再丢失上下文** - **累积学习**，在每次互动的基础上建立 - **语义搜索**，瞬间找到相关的记忆 - **智能重要性**排名和自动清理 ### 📋 **AI 驱动的任务管理** - **将复杂的 PRDs 分解为可行的任务** - **基于项目上下文的智能任务建议** - **带有依赖项管理的进度跟踪** - **上下文相关的子任务生成** ### ⚡ **企业级性能** - **优化查询，响应时间小于 200 毫秒** - **具有 1536 维嵌入的向量搜索** - **99.9% 正常运行时间 SLA**，具有企业级安全性 - **随着代码库的增长，无限扩展** ## 🚀 快速入门 ### 1. 获取您的 API 密钥 ```bash # 在 agentcortex.dev 注册并获取您的 API 密钥 curl -X POST https://api.agentcortex.dev/auth/signup \ -H "Content-Type: application/json" \ -d '{"email":"you@company.com"}' ``` ### 2. 安装和配置 ```bash # 全局安装 npm install -g agentcortex # 或直接运行 npx agentcortex ``` ### 3. 添加到您的 AI 助手 #### **Claude Desktop** 添加到您的 `claude_desktop_config.json` 文件： ```json { "mcpServers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } ``` #### **Cursor IDE** 添加到 Cursor 设置 → MCP 或您的 `cursor_settings.json`： ```json { "mcp.servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } ``` #### **Windsurf IDE** 添加到您的 Windsurf 配置文件： ```json { "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } } ``` #### **Claude Code（VS Code 扩展）** 添加到您的 VS Code 用户设置（JSON）或 `.vscode/mcp.json`： ```json { "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key_here" } } } } } ``` ## 💡 真实使用案例 ### 项目上下文隔离实战 ```bash # 处理您的 React 电商应用 人类：我们正在使用 React 18 和 TypeScript 以及 Zustand 进行状态管理 AI：✅ 存储在 TaskMem → 项目：“ecommerce-frontend” # 切换到您的 Python API 项目 人类：切换到我的 Python API 项目 AI：🔄 切换到“payment-api”项目上下文 # 现在在 Python 上下文中工作 - React 知识不会干扰 人类：我应该为 API 使用什么框架？ AI：🔍 基于您的“payment-api”项目：FastAPI 和 Pydantic 进行验证 （没有提到 React/TypeScript - 清洁的上下文分离！） ``` ### 实际工作的语义记忆 ```bash 人类：我们决定如何处理错误？ AI：🔍 找到 3 个相关记忆： 1. [94% 匹配] “使用 React 错误边界处理组件故障” 2. [89% 匹配] “在生产环境中将错误记录到 Sentry” 3. [85% 匹配] “显示用户友好的消息，永远不要暴露堆栈跟踪” 所有这些都来自您当前的项目上下文。 ``` ### 智能任务分解 ```bash 人类：分解用户身份验证系统的实现 AI：📋 任务分解为 6 个子任务： ✅ 研究 React 18 的身份验证模式 🔄 设置 Supabase Auth 集成 ⏳ 实现登录/注册表单 ⏳ 添加受保护的路由中间件 ⏳ 创建用户配置文件管理 ⏳ 添加会话持久性逻辑 预计：2-3 天，基于您的项目复杂性 ``` ## 🛠️ 完整的工具参考 | 工具 | 功能 | 何时使用 | |------|-------------|-------------| | **项目管理** | | `create_project` | 创建新的隔离项目上下文 | 开始处理新代码库时 | | `set_current_project` | 在项目上下文之间切换 | 在不同仓库之间切换时 | | `get_current_project` | 显示活动项目信息 | 确认您正在处理的项目 | | `list_projects` | 列出所有项目上下文 | 查看所有代码库 | | `get_project_context` | 项目概述和摘要 | 快速了解项目 | | **记忆操作** | | `store_memory` | 保存重要项目信息 | 记录决策、模式、配置 | | `search_memory` | 使用语义搜索查找记忆 | “我们决定了什么……？” | | `get_memories` | 列出记忆并过滤 | 浏览项目知识库 | | `update_memory_importance` | 调整记忆优先级（1-10） | 提升关键信息 | | **任务管理** | | `create_task` | 添加新任务到项目 | 跟踪功能工作、错误、技术债务 | | `list_tasks` | 查看任务并过滤状态 | 查看待处理/进行中的任务 | | `update_task_status` | 更改任务进度 | 将任务标记为完成 | | `suggest_next_task` | AI 驱动的任务建议 | “接下来我应该处理什么？” | | `break_down_task` | 将复杂工作分解为子任务 | 将 PRD 转换为可行的步骤 | ## 🎯 高级用法模式 ### 团队工作流 ```bash # 与团队成员共享项目上下文 人类：导出此项目的记忆以进行入职培训 AI：📦 为“ecommerce-frontend”生成入职培训包 → 包括：架构决策、编码标准、设置指南 → 与：新团队成员共享以获取即时上下文 # 导入团队知识 人类：导入后端团队的 API 文档记忆 AI：✅ 导入了来自“payment-api”项目的 47 个记忆 → 现在在处理前端集成时可用 ``` ### 跨项目洞察 ```bash # 从跨项目中学习模式 人类：我之前使用过哪些身份验证模式？ AI：🔍 跨项目： - ecommerce-frontend：Supabase Auth + React Context - admin-dashboard：Auth0 + JWT tokens - mobile-app：Firebase Auth + AsyncStorage 建议：在 React 模式中使用 Supabase 以保持一致性 ``` ## 🔧 配置 ### 环境变量 | 变量 | 描述 | 必需 | 默认值 | |----------|-------------|----------|---------| | `AGENTCORTEX_API_KEY` | 来自 [agentcortex.dev](https://agentcortex.dev) 的 API 密钥 | ✅ | - | | `AGENTCORTEX_API_URL` | API 端点覆盖 | ❌ | `https://api.agentcortex.dev` | | `AGENTCORTEX_PROJECT_AUTO_DETECT` | 从 git 仓库自动检测项目 | ❌ | `true` | | `AGENTCORTEX_DEFAULT_IMPORTANCE` | 默认记忆重要性级别 | ❌ | `5` | ### 高级配置 **Claude Desktop**： ```json { "mcpServers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key", "AGENTCORTEX_PROJECT_AUTO_DETECT": "true", "AGENTCORTEX_DEFAULT_IMPORTANCE": "7" } } } } ``` **Cursor/Windsurf/Claude Code**： ```json { "mcp": { "servers": { "agentcortex": { "command": "npx", "args": ["agentcortex"], "env": { "AGENTCORTEX_API_KEY": "your_api_key", "AGENTCORTEX_PROJECT_AUTO_DETECT": "true", "AGENTCORTEX_DEFAULT_IMPORTANCE": "7" } } } } } ``` ## 🔐 定价 | 计划 | 价格 | 项目 | 每月记忆 | 任务管理 | 支持 | |------|-------|----------|----------------|-----------------|---------| | **开发者** | **免费** | 1 个项目 | 1,000 记忆 | 基础 | 社区 | | **专业版** | **$29/月** | 无限 | 无限 | 高级 | 优先级 | | **团队版** | **$99/月** | 无限 | 无限 | 协作 | 专属 | **所有计划均包括**： - ✅ 项目上下文分离 - ✅ 语义搜索 - ✅ 99.9% 正常运行时间 SLA - ✅ 企业级安全性 - ✅ MCP 协议支持 ## 🧪 开发和贡献 ```bash # 克隆和设置 git clone https://github.com/sage-hq/agentcortex.git cd agentcortex/apps/mcp npm install # 开发并热重载 npm run dev # 构建生产版本 npm run build # 运行测试 npm test # 发布到 npm npm run publish ``` ### 贡献指南 1. **分叉** 仓库 2. **创建** 功能分支：`git checkout -b feature/amazing-feature` 3. **添加** 新功能测试 4. **确保** TypeScript 类型正确 5. **测试** 多个 MCP 客户端 6. **提交** 拉取请求 ## 🤝 社区和支持 - 📖 **文档**：[docs.agentcortex.dev](https://docs.agentcortex.dev) - 💬 **讨论**：[GitHub Discussions](https://github.com/sage-hq/agentcortex/discussions) - 🐛 **错误报告**：[GitHub Issues](https://github.com/sage-hq/agentcortex/issues) - 🚀 **功能请求**：[功能板块](https://agentcortex.dev/features) - 📧 **电子邮件支持**：support@agentcortex.dev ## 🏆 开发者为什么喜欢 AgentCortex > *"终于有一个 AI 不会在我切换到 Python API 项目时忘记我的 React 模式。改变游戏规则。"* > **— Sarah Chen, Stripe 高级工程师** > *"AgentCortex 解决了我们最大的痛点：新开发者的入职培训。现在他们可以立即获得 20 多个微服务的上下文信息。"* > **— Marcus Rodriguez, DataDog 技术负责人** > *"项目隔离非常出色。我的 AI 助手实际上知道我的 TypeScript 和 Go 代码库之间的区别。"* > **— Alex Kim, Vercel 首席工程师** ## 📈 路线图 - 🔄 **与 Git 自动同步**：从仓库自动检测项目 - 🤖 **代码分析**：AI 驱动的代码库理解和建议 - 🔍 **高级搜索**：跨代码、文档和对话的全文搜索 - 🎯 **智能建议**：主动记忆和任务建议 - 🌐 **VS Code 扩展**：与流行编辑器的直接集成 - 👥 **团队协作**：共享项目上下文和知识库 ## 📝 许可证 MIT 许可证 - 参见 [LICENSE](LICENSE) 文件了解详情。 --- **🚀 准备好让您的 AI 拥有完美的记忆吗？** ```bash npx agentcortex ``` *从今天开始，永远不会再丢失上下文。*