AgentX 是一个基于大模型 (LLM) 和多能力平台 (MCP) 的智能 Agent 构建平台。它致力于简化 Agent 的创建流程，让用户无需复杂的流程节点或拖拽操作，仅通过自然语言和工具集成即可打造个性化的智能 Agent。
- 🛡️ 高可用网关: API-Premium-Gateway - 模型高可用组件
- 🌐 MCP网关: mcp-gateway - MCP服务统一管理
- 🏪 MCP社区: agent-mcp-community - MCP Server 开源社区
- 🎥 项目教程: B站视频教程
- 📖 详细教学: 敲鸭社区 - code.xhyovo.cn
- 🎯 项目演示: 在线PPT介绍
适用于想要快速体验完整功能的用户，无需下载源码，一个命令启动所有服务：
# 下载配置文件模板
curl -O https://raw.githubusercontent.com/lucky-aeon/AgentX/master/.env.example
# 复制并编辑配置
cp .env.example .env
# 根据需要修改 .env 文件中的配置# 一键启动（包含前端+后端+数据库+消息队列）
# 🎯 智能适配：本地、内网、服务器环境均可使用相同命令
docker run -d \
--name agentx \
-p 3000:3000 \
-p 8088:8088 \
-p 5432:5432 \
-p 5672:5672 \
-p 15672:15672 \
--env-file .env \
-v agentx-data:/var/lib/postgresql/data \
-v agentx-storage:/app/storage \
-v /var/run/docker.sock:/var/run/docker.sock\
--add-host=localhost:host-gateway \
ghcr.nju.edu.cn/lucky-aeon/agentx:latest🚀 智能部署：无需区分本地或服务器环境，前端自动检测当前访问IP并连接对应的后端服务
| 服务 | 地址 | 说明 |
|---|---|---|
| 主应用 | http://localhost:3000 | 前端界面 |
| 后端API | http://localhost:8088 | API服务 |
| 数据库 | http://localhost:5432 | PostgreSQL（可选） |
| RabbitMQ | http://localhost:5672 | 消息队列（可选） |
| RabbitMQ管理 | http://localhost:15672 | 队列管理界面（可选） |
如需API高可用功能，可额外部署：
docker run -d \
--name agentx-gateway \
-p 8081:8081 \
ghcr.io/lucky-aeon/api-premium-gateway:latest默认登录账号：
- 管理员：
[email protected]/admin123 - 测试用户：
[email protected]/test123
本地开发：
# 访问: http://localhost:3000
# API自动指向: http://localhost:8088/api ✅内网服务器：
# 访问: http://192.168.1.100:3000
# API自动指向: http://192.168.1.100:8088/api ✅公网服务器：
# 访问: http://your-server-ip:3000
# API自动指向: http://your-server-ip:8088/api ✅
# 访问: http://your-domain.com:3000
# API自动指向: http://your-domain.com:8088/api ✅💡 提示：生产环境部署前，请在.env文件中修改默认密码和JWT密钥
适用于需要修改代码或定制功能的开发者：
# 1. 克隆项目
git clone https://github.com/lucky-aeon/AgentX.git
cd AgentX/deploy
# 2. 启动开发环境（Linux/macOS）
./start.sh
# 2. 启动开发环境（Windows）
start.bat开发环境特色：
- 🔥 代码热重载
- 🛠 数据库管理工具
- 🐛 调试端口开放
- 📊 详细开发日志
- Agent 管理（创建/发布）
- LLM 上下文管理（滑动窗口，摘要算法）
- Agent 策略（MCP）
- 大模型服务商
- 用户
- 工具市场
- MCP Server Community
- MCP Gateway
- 预先设置工具
- Agent 定时任务
- Agent OpenAPI
- 模型高可用组件
- RAG
- 计费
- Agent 监控
- 嵌入网站组件
- Multi Agent
- 知识图谱
- 长期记忆
AgentX使用.env配置文件进行环境变量管理，支持丰富的自定义配置：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 基础服务 | ||
SERVER_PORT |
后端API端口 | 8088 |
DB_PASSWORD |
数据库密码 | agentx_pass |
RABBITMQ_PASSWORD |
消息队列密码 | guest |
| 安全配置 | ||
JWT_SECRET |
JWT密钥（必须修改） | 需要设置 |
AGENTX_ADMIN_PASSWORD |
管理员密码 | admin123 |
| 外部服务 | ||
EXTERNAL_DB_HOST |
外部数据库地址 | 空（使用内置） |
EXTERNAL_RABBITMQ_HOST |
外部消息队列地址 | 空（使用内置） |
# 1. 获取配置模板
curl -O https://raw.githubusercontent.com/lucky-aeon/AgentX/main/.env.example
# 2. 创建配置文件
cp .env.example .env
# 3. 编辑配置（必改项）
vim .env必须修改的配置项：
JWT_SECRET: 设置安全的JWT密钥（至少32字符）AGENTX_ADMIN_PASSWORD: 修改管理员密码DB_PASSWORD: 修改数据库密码
🔐 安全配置（重要）
# 生产环境必须修改
JWT_SECRET=your_secure_jwt_secret_key_at_least_32_characters
AGENTX_ADMIN_PASSWORD=your_secure_admin_password
DB_PASSWORD=your_secure_db_password
RABBITMQ_PASSWORD=your_secure_mq_password🔗 外部服务集成
# 使用外部数据库
EXTERNAL_DB_HOST=your-postgres-host
DB_HOST=your-postgres-host
DB_USER=your-db-user
DB_PASSWORD=your-db-password
# 使用外部消息队列
EXTERNAL_RABBITMQ_HOST=your-rabbitmq-host
RABBITMQ_HOST=your-rabbitmq-host
RABBITMQ_USERNAME=your-mq-user
RABBITMQ_PASSWORD=your-mq-password☁️ 云服务配置
# 阿里云OSS
OSS_ENDPOINT=https://oss-cn-beijing.aliyuncs.com
OSS_ACCESS_KEY=your_access_key
OSS_SECRET_KEY=your_secret_key
OSS_BUCKET=your_bucket_name
# AWS S3
S3_SECRET_ID=your_s3_access_key
S3_SECRET_KEY=your_s3_secret_key
S3_REGION=us-east-1
S3_BUCKET_NAME=your_bucket
# AI服务
SILICONFLOW_API_KEY=your_api_key
HIGH_AVAILABILITY_ENABLED=true
HIGH_AVAILABILITY_GATEWAY_URL=http://localhost:8081📧 通知与认证
# 邮件服务
MAIL_SMTP_HOST=smtp.qq.com
MAIL_SMTP_USERNAME=[email protected]
MAIL_SMTP_PASSWORD=your_email_password
# GitHub OAuth
GITHUB_CLIENT_ID=your_github_client_id
GITHUB_CLIENT_SECRET=your_github_client_secret
# 支付服务
ALIPAY_APP_ID=your_alipay_app_id
STRIPE_SECRET_KEY=your_stripe_secret_key📋 完整配置参考：查看 .env.example 文件了解所有可配置参数
| 文档 | 说明 |
|---|---|
| 生产部署指南 | 生产环境完整部署 |
| 开发部署指南 | 开发者环境配置 |
| 故障排查手册 | 问题诊断和解决 |
我们致力于构建一个活跃的开发者社区，欢迎各种形式的交流与合作！
如有技术问题或商务合作，可添加开发者微信：
加入我们的技术交流群，与更多开发者一起讨论：
关注我们的公众号，获取最新技术动态和产品更新：
如果二维码过期或无法扫描，请通过私人微信联系我。