AGI-MCP：高级通用智能模型上下文协议服务器
  ](https://nodejs.org/)
一个全面的模型上下文协议（MCP）服务器，通过 GOTCHA框架, ATLAS工艺, 思维机制, 钉钩系统，以及 子代理架构 具有用于持久状态管理的集成数据库内存。
🌟 特性
🎯 GOTCHA框架（6层架构）
代理系统的复杂认知架构：
- 目标（G） -定义和管理具有优先级的目标
- 观察结果（O） -感知并记录环境状态
- 思考（T） -基于观察的原因和计划
- 命令（C） -系统地选择和执行行动
- 假设（H） -形成并验证预测
- 评估（A） -评估绩效并总结经验教训
🗺️ ATLAS过程（5步方法）
结构化任务执行方法：
- 分析（A） -了解任务背景和复杂性
- 任务分解（T） -分解为可管理的子任务
- 学习（L） -收集必要的知识和资源
- 法案（A） -系统地执行计划行动
- 合成（S） -整合结果并提取见解
🧠 思维机制
智能推理和过滤层：
- 快速评估 -评估用户输入的相关性和安全性
- 工具使用验证 -评估工具执行的适当性
- 完工评估 -确定工作何时真正完成
- 基于目的的过滤 -使所有操作与代理目的保持一致
🔗 钉钩系统
Claude Code风格的生命周期钩子用于定制：
- 11钩事件 -SessionStart、UserPromptSubmit、PreToolUse、PostToolUse、Stop、SubagentStart/Stop等
- 命令和提示挂钩 -shell命令和基于LLM的评估
- 决策控制 -允许、拒绝或动态修改操作
- 上下文注入 -在关键生命周期点添加信息
🤖 子代理系统
专注任务的专业人工智能助手：
- 4内置子代理 -探索、通用、任务执行者、代码审查者
- 自定义子代理 -创建项目或用户级专家
- 孤立的上下文 -每个子代理都有自己的内存和权限
- 工具限制 -对子代理功能进行细粒度控制
- 可恢复的会话 -继续之前的子代理工作
💾 数据库集成
持久记忆作为真理之源：
- SQLite数据库 -所有操作都持续进行
- 会话跟踪 -完整的历史记录和分析
- 阿特拉斯历史 -完整的执行跟踪
- 查询优化 -按性能索引
🏗️ 内存基础架构
自动初始化和管理：
- 自动检测 -检查现有基础设施
- 目录创建 -
memory/logs和data结构 - 架构初始化 -首次运行时的数据库设置
- 日志系统 -全面的会话日志
📦 安装
标准安装
# Clone the repository
git clone https://github.com/muah1987/AGI-MCP.git
cd AGI-MCP
# Install dependencies
npm install
# Build the project
npm run build
# Run tests
npm testDocker安装
# Option 1: Pull from Docker Hub (recommended)
docker pull muah1987/agi-mcp:latest
# Option 2: Build locally
docker build -t agi-mcp:latest .
# Option 3: Use docker-compose
docker-compose build
# Run the test script to validate the build
./test-docker.sh发布到Docker Hub
手工出版
# 1. Create .env file with your credentials
cp .env.example .env
# Edit .env and add your DOCKER_USERNAME and DOCKER_TOKEN
# 2. Build and push to Docker Hub
./push-docker.sh使用GitHub操作自动发布
该仓库包含一个GitHub Actions工作流，该工作流在每次向主分支推送或创建标签时自动构建Docker镜像并将其推送到DockerHub。
设置：
- 将以下机密添加到您的GitHub存储库设置中：
- DOCKER_LOGIN -您的DockerHub用户名 - DOCKER_PASSWORD -您的DockerHub密码或访问令牌
- 工作流将自动执行以下操作：
- 使用Dockerfile构建Docker镜像 - 标记它 latest 版本来自 package.json - 将其推送到DockerHub下 $DOCKER_LOGIN/agi-mcp （其中 $DOCKER_LOGIN 是您的DockerHub用户名）
手动触发器：
您还可以从GitHub中的Actions选项卡手动触发工作流。
🚀 快速开始
作为MCP服务器（本机）
添加到您的MCP客户端配置中（例如，Claude Desktop、Cline）：
{
"mcpServers": {
"agi-mcp": {
"command": "node",
"args": ["/absolute/path/to/AGI-MCP/dist/index.js"]
}
}
}作为MCP服务器（Docker）
使用Docker进行隔离部署：
{
"mcpServers": {
"agi-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "muah1987/agi-mcp:latest"]
}
}
}或者使用本地构建的映像：
{
"mcpServers": {
"agi-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "agi-mcp:latest"]
}
}
}直接执行
# Native
npm start
# Docker
docker run -i agi-mcp:latest
# Docker Compose
docker-compose up第一次会议
首次运行时，AGI-MCP会自动：
- 创建
memory/MEMORY.md文档 - 设置
memory/logs/目录 - 创建
data/目录 - 初始化SQLite数据库
- 加载所有子代理
- 配置挂钩系统
🛠️ 可用工具
GOTCHA框架（7个工具）
set_goal-定义系统目标observe-记录环境观测结果think-捕获推理过程execute_command-执行和记录命令form_hypothesis-创建预测assess_performance-评估和学习process_goal_with_gotcha-全周期处理
ATLAS流程（2个工具）
execute_atlas_task-运行完整的5步流程get_atlas_history-查看任务执行历史记录
内存管理（3个工具）
get_active_goals-列出活动目标get_memory-按层查询内存get_session_summary-会话概述
子代理管理（3个工具）
execute_subagent-专家代表resume_subagent-继续之前的工作list_subagents-查看可用的子代理
📚 文档
核心文件
技术文档（docs/）
- docs/ARCHITECTURE.md -系统架构与设计
- docs/ADVANCED.md -思维机制、钩子和子代理
- docs/USAGE.md -带示例的综合使用指南
- docs/SKILLS.md -技能体系和编排
- docs/QUICKREF.md -开发人员快速参考
- docs/AGENTS.md -子代理文件
- docs/GETTING_STARTED.md -快速入门指南
- 文档/部署.md -部署指南
- docs/API.md文件 -完整的API文件
- docs/MEMORY_SYSTEM.md -内存架构
- 文档/项目\_ SUMMARY.md -项目统计
🏗️ 建筑
AGI-MCP/
├── src/
│ ├── index.ts # Main MCP server
│ ├── database/
│ │ ├── memory-db.ts # SQLite operations
│ │ └── infrastructure.ts # Auto-initialization
│ ├── gotcha/
│ │ ├── framework.ts # GOTCHA 6-layer system
│ │ └── thinking.ts # Thinking mechanism
│ ├── atlas/
│ │ └── process.ts # ATLAS 5-step process
│ ├── hooks/
│ │ └── hook-system.ts # Lifecycle hooks
│ ├── subagents/
│ │ └── subagent-system.ts # Subagent management
│ └── tools/
│ └── mcp-tools.ts # MCP tool definitions
├── memory/ # Memory system
│ ├── MEMORY.md # Documentation
│ └── logs/ # Session logs
├── data/ # Database storage
│ └── agi-mcp.db # SQLite database
└── .agi-mcp/ # Configuration
├── hooks/ # Hook scripts
├── subagents/ # Custom subagents
└── hooks-config.json # Hook configuration💡 示例
执行ATLAS任务
await tools.handleToolCall('execute_atlas_task', {
task_id: 'research-001',
description: 'Research quantum computing applications'
});使用子代理
await tools.handleToolCall('execute_subagent', {
subagent: 'code-reviewer',
task: 'Review authentication module for security'
});配置挂钩
{
"hooks": {
"PreToolUse": [{
"matcher": "execute_command",
"hooks": [{
"type": "command",
"command": "./validate-command.sh"
}]
}]
}
}🧪 测试
# Run all tests
npm test
# Build project
npm run build🤝 贡献
欢迎投稿！看 贡献.md 作为指导方针。
📄 许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
🔒 安全
看 安全.md 用于安全策略和报告漏洞。
📝 更新日志
看 更改日志.md 查看版本历史和更改。
🙏 致谢
- 基于Anthropic的模型上下文协议
- 受AGI原则和认知架构的启发
- 使用TypeScript和SQLite构建
📧 支持
______________________________________________________________________
AGI-MCP -通过模型上下文协议实现通用人工智能