# 🦀 AsClaw
**让每个 AI Agent 都能调用世界的工具**
MCP 服务器与 AI Skills 的发现、编译、托管代理与智能体编排平台
[English](README.md) | 简体中文
**[快速开始](#-快速开始) · [功能特性](#-功能特性) · [核心工作流](#-核心工作流) · [技术架构](#️-技术架构) · [界面导览](#-界面导览)**
*🏠 首页 — 国风山水仙境视觉，「智能体将改变世界」，企业入驻与一键登录入口*
## ✨ 功能特性
- 🧩 **MCP 市场** — 广场按分类浏览与搜索公开的 MCP 服务器，卡片式展示（本地/远程服务、是否需要 Token、工具数量）
- ⚡ **一键导入** — 粘贴 `mcpServers` 配置片段或 npm/pip 包名，支持 `stdio` / `SSE` / `Streamable-HTTP` 三种传输方式，另有 HTTP 接口直转 MCP 模式
- 🔍 **自动编译内省** — Celery 异步任务基于 fastmcp Client 连接服务器，自动解析 tools / prompts / resources 并持久化元数据
- 🛫 **托管代理（Hosted Proxy）** — 本地 `stdio` 服务器按运行时匹配基础镜像（Node / Python），经 `mcp-proxy` 封装为 SSE 端点后部署到阿里云函数计算，无需客户端本地运行环境
- 🤖 **Agent 可视化编排** — 系统提示词 + 开场白 + 勾选绑定 MCP/Skill + 能力开关（联网搜索、问题建议、公开到广场），一键发布
- 💬 **AG-UI 实时聊天** — CopilotKit + AG-UI 协议 SSE 事件流，工具调用链全程可视化，多会话管理与 AI 自动生成标题
- 🧠 **Skills 市场** — 遵循 SKILL.md 标准：填 GitHub 目录地址自动抓取归档（`scripts/`、`references/`），或直接在线编写发布
- 🔑 **BYOK 模型密钥** — 自带 OpenAI 兼容密钥（阿里云百炼 / DeepSeek / Kimi 等），个人密钥与企业共享密钥两级隔离，AES 加密落库，平台不代跑大模型
- 🏢 **企业入驻** — 资质申请 → 管理员审核 → 企业账号登录；企业全体成员共享模型密钥
- 🛡️ **管理后台** — 服务器审核、公开/推荐管理、分类管理、企业入驻审核、用户管理
## 🗺️ 核心工作流
```mermaid
flowchart LR
A[📥 导入
🧩 MCP 广场 — 17+ 服务器卡片流：本地/远程徽标、Token 要求、工具计数，分类检索一键直达 |
🏢 企业入驻 — 工商资质信息 + 企业账号一次填完，管理员审核通过即可登录 |
🔐 企业登录 — 极简登录卡片，成功态即时反馈直达工作台 |
📤 提交 MCP — MCP 配置 / HTTP 接口双模式，粘贴 mcpServers JSON 即完成导入 |
🧠 导入 Skill — 左侧表单 + 右侧 SKILL.md 规范速查，GitHub 目录自动抓取或在线编写 |
🔑 个人中心 — 账户 / 我的 MCP / Skill / 部署记录 / 模型密钥一抽屉直达，BYOK 密钥掩码管理
💬 Agent 聊天 — 左栏多会话历史，@ 智能体即问即答，AI 自动生成会话标题 |
🤖 创建 Agent — 系统提示词 + 开场白 + 勾选绑定 MCP/Skill + 能力开关，所见即所得的编排 |
⚡ 工具调用可视化 — 天气/地理编码/车票查询调用链全程展开，最终输出结构化出行报告 |
## 🚀 快速开始
MySQL 和 Redis 用 Docker 容器跑，其余服务（API、Celery worker、前端）直接在本地跑。
### 前置安装
| 工具 | 版本 | 用途 |
|------|------|------|
| Docker + Docker Compose | — | 运行 MySQL 与 Redis（容器） |
| Python | 3.10+ | 后端 |
| uv | 最新 | 后端依赖与虚拟环境 |
| Node.js | 20+ | 前端 |
| pnpm | 9+ | 前端依赖 |
### 1. 启动 MySQL 与 Redis（容器）
```shell
git clone https://gitee.com/lang_junnan_admin/asclaw.git && cd asclaw
cd docker
docker compose -f docker-compose.dev.yml up -d
```
**首次**启动（空数据卷）时，MySQL 会按文件名顺序自动执行
`docker/sql/mysql/init/*.sql` —— 创建 `asclaw` 与 `asclaw_chat` 两个库，并写入后台
`sys_menu` 菜单种子。无需手动执行 SQL；后续启动不会重复执行。
### 2. 后端
```shell
cd backend
uv sync && source .venv/bin/activate
cp .env.example .env # 按需修改 DATABASE_PASSWORD / DASHSCOPE_API_KEY
alembic upgrade head # 应用全部迁移（含增量表结构变更）
asclaw run --port 8081 # API :8081（Swagger /docs）
```
### 3. Celery worker + beat（另开终端；MCP 编译/部署任务必需）
```shell
asclaw celery worker # 执行编译/部署任务
asclaw celery beat # 定时：每 30 秒同步部署日志状态
```
> 两者都是普通前台进程（开发环境无自动重启）——做编译/部署期间保持运行；若其中一个挂了，重跑 `./start.sh`（会自动跳过已在运行的）。
### 4. 前端
```shell
cd frontend
pnpm install
cp .env.example .env.local # NEXT_PUBLIC_API_BASE_URL=http://localhost:8081
pnpm dev -p 3001 # :3001
```
启动完成后：
| 服务 | 地址 |
|------|------|
| 前端 Web |