Easypanel MCP

易面板mcp

MCP服务器 EasyPanel --通过任何兼容MCP的AI代理（Claude、Cursor等）管理您的服务器、项目、服务、数据库和域。

40个精选工具 +原始tRPC访问所有 347 EasyPanel API程序.

🚀 快速设置（在EasyPanel上部署）

最简单的方法是将MCP服务器作为服务部署在您自己的EasyPanel上。选择身份验证模式：

• OAuth （推荐）--用户在浏览器弹出窗口中使用Easypanel电子邮件/密码登录。没有要生成或粘贴的令牌。按用户访问。
• 持票人 -一个共享的API密钥+一个Easypanel令牌烘焙到env vars中。

OAuth模式（浏览器登录，每个用户）

1. 创建项目（例如。 mcp)，添加一个 应用 GitHub上的服务 dray-supadev/easypanel-mcp
2. 添加域（例如。 mcp.your-domain.com)
3. 设置环境变量：

   EASYPANEL_URL=http://easypanel:3000
   EASYPANEL_MCP_MODE=http
   EASYPANEL_AUTH_MODE=oauth
   OAUTH_ISSUER_URL=https://mcp.your-domain.com
   MCP_ACCESS_MODE=readonly
   PORT=3000

1. （可选但推荐）在以下位置安装卷 /data 并设置 OAUTH_STORE_PATH=/data/oauth.json 因此，代币可以在重新部署后幸存下来。
2. 部署。

连接Claude Desktop或其他支持OAuth的MCP客户端：

{
  "mcpServers": {
    "easypanel": { "url": "https://mcp.your-domain.com/mcp" }
  }
}

首次使用时，客户端将弹出一个浏览器窗口，询问您的Easypanel凭据，然后将您的访问令牌返回给Claude。无需手动卷曲。

登录页面调用Easypanel的 auth.login 并将会话令牌绑定到此MCP服务器范围内的不透明OAuth访问令牌。凭据从不存储。

承载模式（共享密钥，更简单）

1. 获取您的API令牌：

   curl -X POST https://YOUR_PANEL:3000/api/trpc/auth.login \
     -H "Content-Type: application/json" \
     -d '{"json":{"email":"you@email.com","password":"your-pass"}}'

> 如果您启用了2FA，请添加 "code":"123456" 使用您的身份验证码。

响应包含 "token":"xxx" -这是您的API令牌。

> ⚠️ 这是一个 会话令牌 30天后到期。对于永久令牌，请使用 users.generateApiToken （见下文）。

1. 在EasyPanel上部署：

   EASYPANEL_URL=http://easypanel:3000
   EASYPANEL_TOKEN=your-api-token
   EASYPANEL_MCP_MODE=http
   MCP_API_KEY=your-secret-key
   MCP_ACCESS_MODE=readonly
   PORT=3000

> 重要提示： 使用 http://easypanel:3000 （内部Docker网络）在同一EasyPanel实例上部署时。 > MCP_ACCESS_MODE: readonly 阻止所有写入操作；着手 full 以允许突变。 > ⚠️ 集 MCP_API_KEY --没有它，任何拥有该URL的人都可以控制您的服务器。仅使用字母数字(!, %, ^ 可能会破坏env变量）。

1. 连接克劳德桌面：

   {
     "mcpServers": {
       "easypanel": {
         "url": "https://mcp.your-domain.com/mcp",
         "headers": { "Authorization": "Bearer your-secret-key" }
       }
     }
   }

重新启动克劳德桌面。完成！让克劳德“展示我的项目”🎉

💻 本地设置（备选）

通过stdio在本地运行MCP服务器（无需部署）：

git clone https://github.com/dray-supadev/easypanel-mcp.git
cd easypanel-mcp
npm install && npm run build

{
  "mcpServers": {
    "easypanel": {
      "command": "node",
      "args": ["/path/to/easypanel-mcp/dist/index.js"],
      "env": {
        "EASYPANEL_URL": "https://your-panel:3000",
        "EASYPANEL_TOKEN": "your-api-token"
      }
    }
  }
}

🔧 可用工具（40）

项目

list_projects · create_project · destroy_project · inspect_project

应用服务

create_app · inspect_app · deploy_app · start_app · stop_app · restart_app · destroy_app · set_app_source_image · set_app_source_github · set_app_env · set_app_resources

数据库（PostgreSQL、MySQL、MariaDB、MongoDB、Redis）

create_database · inspect_database · destroy_database

域和端口

list_domains · create_domain · delete_domain · create_port · list_ports

卷

create_mount · list_mounts

监控

system_stats · service_stats · storage_stats

Docker Compose

create_compose · inspect_compose · deploy_compose

系统

cleanup_docker · system_prune · restart_panel · reboot_server · list_users · list_certificates · list_nodes · deploy_template

逃生舱口

trpc_raw --直接调用347 tRPC程序中的任何一个

🔒 安全

• OAuth模式 --每个用户通过浏览器登录访问；MCP服务器充当OAuth 2.1授权服务器（根据RFC 7591需要PKCE、动态客户端注册）。访问令牌是不透明的，绑定到用户的Easypanel会话令牌服务器端；凭据永远不会以存储的形式离开此服务器。
• 承载模式 — MCP_API_KEY 保护端点， EASYPANEL_TOKEN 用于所有API调用。
• 健康终点(/health)始终是公开的（不返回敏感数据）。
• 在本地/stdio模式下，不需要网络身份验证。

环境变量

OAuth端点

当 EASYPANEL_AUTH_MODE=oauth，服务器公开：

• GET /.well-known/oauth-authorization-server --RFC 8414元数据
• GET /.well-known/oauth-protected-resource --RFC 9728元数据
• POST /register --RFC 7591动态客户端注册
• GET /authorize --登录页面
• POST /authorize --凭证→ 授权码（302重定向到客户端）
• POST /token — authorization_code 和 refresh_token 赠款（需要S256 PKCE）

生成永久API令牌

会话令牌来自 auth.login 30天后到期。对于永久令牌：

步骤1。 获取您的用户ID:

curl -s "https://YOUR_PANEL:3000/api/trpc/users.listUsers" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

在回复中找到您的电子邮件并复制 "id" 现场。

步骤2。 生成永久令牌：

curl -s -X POST "https://YOUR_PANEL:3000/api/trpc/users.generateApiToken" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"json":{"id":"YOUR_USER_ID"}}'

步骤3。 检索令牌--再次列出用户：

curl -s "https://YOUR_PANEL:3000/api/trpc/users.listUsers" \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

您的用户现在拥有 "apiToken" 字段——这是永久标记。设置为 EASYPANEL_TOKEN 在您的MCP服务环境中。

此令牌 永不过期 除非您通过以下方式撤销 users.revokeApiToken.

运作原理

EasyPanel在 /api/trpc/这个MCP服务器是通过逆向工程EasyPanel的前端构建的，可以提取43个命名空间中的所有347个过程名称，然后将最有用的名称映射到类型化的MCP工具。

免责声明

该工具与EasyPanel的公共tRPC API进行通信。EasyPanel的某些功能可能需要有效的许可证。请尊重 EasyPanel的许可条款。本项目不隶属于EasyPanel或得到EasyPanel的认可。

许可证

麻省理工学院