内容
# GPT‑管理
[](LICENSE)
[](https://www.python.org/)
[](#)
[](#工作原理)
**一个MCP中心 — 任意AI控制任意基础设施。**
GPT‑管理是一款自托管的MCP中心,位于您的AI助手和服务器之间。 将服务器和任意MCP工具插入中心,然后通过三个适配器之一连接您的AI。 从服务器管理到运行子代理 — 从ChatGPT、Claude、Codex、DeepSeek、Qwen,甚至Yandex Alice或Sber GigaChat。
> 🌐 网站和实时文档: **https://gptadmin.bezrabotnyi.com**
> 📚 完整文档: **[docs/](./docs/Home.md)** — 架构、适配器、中心、安装、配置、API、安全、FAQ
> 📦 安装: `curl -s https://became.bezrabotnyi.com/install.sh | bash`
---
## 为什么选择GPT‑管理
大多数“AI服务器管理”工具要么仅限于云端,要么绑定到一个AI,或者需要付费API。 GPT‑管理不同:
- **自托管** — 您的服务器、您的中心、您的令牌。没有任何内容离开您的基础设施。
- **任意AI** — ChatGPT、Claude、Codex、OpenCode、DeepSeek、Qwen、Alice、GigaChat。甚至免费的网络聊天通过浏览器扩展也适用。
- **MCP原生** — 中心使用MCP远程SSE,因此任何MCP客户端都可以连接。插入chrome-devtools、openmemory或任何其他MCP工具。
- **实际执行** — 不是“这里是命令,复制它”。代理读取状态、运行命令、验证并报告实际输出。
## 工作原理
```
MCP工具插入 AI连接输出(3个适配器)
┌─────────────────┐ ┌──────────────────────┐
│ shellmcp │ │ Claude · Codex │ (MCP客户端)
│ chrome-devtools │ ──► ┌──┴──────────────┐ │
│ openmemory │ │ GPT‑管理 │ ──► │ DeepSeek · Qwen │ (浏览器扩展)
│ 任意MCP │ ◄── │ MCP中心 │ │ Alice · GigaChat │
└─────────────────┘ └──┬──────────────┘ ──► │ ChatGPT · OpenUI │ (OpenAI操作)
│ │ └──────────────────────┘
▼
您的服务器
(Linux · macOS · Windows)
```
中心是一个进程。工具插入它。AI通过三个适配器之一连接到它。功能(管理、代码、日志、搜索、子代理)来自中心 — 与您使用的AI无关。
## 快速入门
```bash
# 1. 安装(Linux / macOS — 自动检测用户/系统模式)
curl -s https://became.bezrabotnyi.com/install.sh | bash
# Windows(PowerShell,不需要管理员权限)
iwr -UseBasicParsing https://became.bezrabotnyi.com/install_win.ps1 | iex
```
安装程序会打印您的**中心网址**和**CTL_TOKEN** — 请保存它们。
```bash
# 2. 连接您的AI — 选择一个适配器:
# - OpenAI操作(ChatGPT自定义GPT / Open WebUI)→ 见文档
# - MCP远程SSE(Claude / Codex / OpenCode)→ 见文档
# - 浏览器扩展(免费网络AI)→ 见文档
# 3. 使用它:
# "安装nginx", "修复网站", "显示日志", "运行codex来修复这个bug"
```
每个适配器的完整说明: **https://gptadmin.bezrabotnyi.com/#/docs**
## 您可以通过中心执行的操作
| 功能 | 示例 |
|------------|---------|
| **服务器管理** | 重启systemd服务,管理防火墙/nginx/fail2ban/sshd,安装软件包 |
| **编写和运行代码** | 编辑文件,运行类型检查/编译/构建,启动子代理(“运行codex来修复这个bug”) |
| **修复和清理PR** | 在内存中找到fork,保持一个功能提交,通过SSH强制推送 |
| **检查日志** | 解析journalctl/nginx/postgres,找到异常,建议并应用修复 |
| **网络搜索** | 通过chrome-devtools MCP — 代理打开页面,读取文档,搜索 |
| **诊断事件** | 找到宕机的服务,读取日志,了解原因(ECONNREFUSED,503,OOM),修复它 |
## 三个适配器
| 适配器 | 适用于 | 操作 |
|---------|-----|-----|
| **OpenAI操作** | ChatGPT,Open WebUI | 创建自定义GPT / 添加OpenAPI端点,Bearer令牌。无Codex限制。 |
| **MCP远程SSE** | Claude Desktop,Codex,OpenCode | 中心是MCP服务器(可流式传输的HTTP)。添加到`claude_desktop_config.json`。 |
| **浏览器扩展** | DeepSeek,Qwen,Alice,GigaChat,ChatGPT(免费) | 用户脚本(Tampermonkey/Firefox)为网络聊天UI添加MCP按钮。无付费API。 |
所有三个适配器都连接到**同一个中心**。相同的功能。选择适合您的AI的适配器。
## 安装路径
| 操作系统 | 用户模式(默认) | 系统模式(`sudo`) |
|----|---------------------|----------------------|
| Linux / macOS | `~/.local/share/gptadmin` | `/opt/gptadmin` |
| Windows | `%LOCALAPPDATA%\gptadmin` | `C:\Program Files\gptadmin` |
安装程序自动检测模式:无需`sudo` → 用户模式(主目录,用户服务);`sudo` → 系统模式。无需域名 — 通过FRP或Cloudflare自动隧道提供公共URL。
## 项目布局
```
gptadmin_hub.py # MCP中心 — 将命令代理到代理
hub_watchdog.py # 保持中心运行
server_for_installer.py # 提供安装脚本 + OpenAPI
gptadmin_security.py # 身份验证,OAuth,令牌验证
cli.py # `gptadmin`命令行界面(设置,隧道,状态,日志)
telegram_logs_bot.py # 可选的Telegram警报
go-shellmcp/ # 主要shell代理(Go)— 在目标机器上运行
client/ # 旧Python shell代理(兼容)
public/ # OpenAPI模式,安装脚本,mcp-bridge.user.js
deploy/ # 安装脚本,systemd,nginx配置
tests/ # test_hub.py,test_rootd.py
docs/ # OPEN_CORE_PLAN.md
```
> 结构正在清理中 — 请参见`docs/OPEN_CORE_PLAN.md`以获取目标布局和开放核心启动计划。
## 从源代码运行
```bash
python3 -m venv .venv && source .venv/bin/activate
pip install fastapi uvicorn requests
# 中心(终端1)
CTL_TOKEN=your-token python gptadmin_hub.py
# 目标机器上的代理(终端2)
SHELLMCP_TOKEN=agent-token HUB_URL=http://127.0.0.1:25900 python client/shellmcp.py
# 烟雾测试(终端3)
python tests/test_hub.py
```
## 贡献
欢迎PR。请参见[CONTRIBUTING.md](CONTRIBUTING.md)以获取开发设置、代码样式和PR流程。有关安全问题,请参见[SECURITY.md](SECURITY.md)。
## 许可证
**GNU AGPL-3.0** — 请参见[LICENSE](LICENSE)。
中心、shellmcp、三个适配器和基本网页面板**永久免费**。未来的付费产品(托管云、企业SSO/审计/RBAC、高级面板、支持)将位于一个单独的仓库中 — 核心保持开放。
## 链接
- 🌐 网站和文档: https://gptadmin.bezrabotnyi.com
- 💬 Telegram: [@careviolan](https://t.me/careviolan)
- 📦 其他项目: https://bezrabotnyi.com