1Panel MCP Server
2025.04.14
86
Go系统管理网站管理证书管理应用管理数据库管理其它
1Panel MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，专为 1Panel 设计。它提供了与 1Panel 交互的工具集，支持通过 stdio 或 SSE 模式运行。核心功能包括系统状态监控、网站管理、证书管理、应用安装和数据库管理等。适用于需要自动化管理 1Panel 环境的开发者和系统管理员。
View on GitHub
Overview
基本能力
产品定位
1Panel MCP Server 是一个用于与 1Panel 交互的 MCP 协议服务器，旨在提供自动化管理和操作 1Panel 的能力。
核心功能
- 支持 stdio 和 SSE 两种传输模式。
- 提供多种工具用于系统监控、网站管理、证书管理、应用安装和数据库管理。
- 可以通过命令行参数或环境变量配置服务器。
适用场景
- 自动化管理 1Panel 环境。
- 监控系统状态和资源使用情况。
- 批量管理网站、证书和数据库。
- 自动化安装和管理应用程序。
工具列表
| 工具名称 | 类别 | 描述 |
|---|---|---|
| get_dashboard_info | 系统 | 列出仪表板状态 |
| get_system_info | 系统 | 获取系统信息 |
| list_websites | 网站 | 列出所有网站 |
| create_website | 网站 | 创建一个网站 |
| list_ssls | 证书 | 列出所有证书 |
| create_ssl | 证书 | 创建一个证书 |
| list_installed_apps | 应用 | 列出所有已安装的应用 |
| install_openresty | 应用 | 安装 OpenResty |
| install_mysql | 应用 | 安装 MySQL |
| list_databases | 数据库 | 列出所有数据库 |
| create_database | 数据库 | 创建一个数据库 |
常见问题解答
- 如何配置 MCP 服务器？
可以通过命令行参数或环境变量配置服务器，如
-token、-host、-transport等。 - 支持哪些传输模式？ 支持 stdio 和 SSE 两种模式。
使用教程
使用依赖
- Go 1.23.0 或更高版本（用于二进制使用）
- Docker（用于 Docker 使用）
- 已安装的 1Panel
安装教程
从源代码构建（二进制）
- 克隆仓库：
bash git clone https://github.com/1Panel-dev/mcp-1panel.git cd mcp-1panel - 构建项目：
bash make build将./build/mcp-1panel移动到系统 PATH 包含的目录中。
使用 go install 安装
go install github.com/1Panel-dev/mcp-1panel@latest
调试方式
stdio 模式
确保 Go 已安装且二进制已构建或安装：
{
"mcpServers": {
"mcp-1panel": {
"command": "mcp-1panel",
"env": {
"PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
"PANEL_HOST": "such as http://localhost:8080"
}
}
}
}
Docker 模式
确保 Docker 已安装：
{
"mcpServers": {
"mcp-1panel": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"PANEL_HOST",
"-e",
"PANEL_ACCESS_TOKEN",
"1panel/1panel-mcp-server"
],
"env": {
"PANEL_HOST": "such as http://localhost:8080",
"PANEL_ACCESS_TOKEN": "<your 1Panel access token>"
}
}
}
}
SSE 模式
启动 MCP 服务器：
mcp-1panel -host <your 1Panel access address> -token <your 1Panel access token> -transport sse -addr "http://localhost:8000"
配置 Cursor/Windsurf：
{
"mcpServers": {
"mcp-1panel": {
"url": "http://localhost:8000/sse"
}
}
}