内容
# xCloud MCP
[](https://scorecard.dev/viewer/?uri=github.com/wnstify/xcloud-mcp)
一个本地的MCP服务器，允许您在AI代理内部管理自己的xCloud服务器和站点：Claude Code、Claude Desktop、Codex CLI或其他任何MCP支持的工具。
您只需提供一个xCloud个人访问令牌。它代表您调用xCloud REST API，并为您提供一组精选的工具：列出您的服务器、检查服务器的健康状况、读取站点的日志、触发备份、应用WordPress更新、清除缓存等。它在您的机器上通过stdio运行。您的帐户信息除了您已经向xCloud发送的调用外，不会离开您的机器。
## 为什么您可能需要它
- **询问您的代理关于您的基础设施。** “哪些站点有待处理的WordPress更新？” “这个服务器的磁盘是否已满？” “显示example.com的最近一小时的访问日志。”
- **安全地执行操作。** 在进行风险更改之前创建还原点，运行漏洞扫描，在部署后清除缓存，所有操作都不需要离开代理或在提示中粘贴凭证。
- **默认安全。** 您无需配置任何内容即可确保安全。读取和安全写入工具开箱即用；任何破坏性操作都隐藏，直到您有意启用并在运行前询问。参见 [SECURITY.md](SECURITY.md)。
## 要求
- **Node.js 24 或更新版本。**
- **xCloud个人访问令牌（PAT）。** 在 `app.xcloud.host` 的帐户下创建，然后是API令牌。根据需要限制其范围。该令牌是您的实际安全边界，因此只读令牌只能用于读取。有关如何存储它，请参见 [USAGE.md](USAGE.md)。
## 快速开始
> [!CAUTION]
> 将令牌从纯文本配置文件中分离出来（从macOS Keychain、Windows Credential Manager、gopass、1Password或Vault中提取）是一个单行更改，详见 [USAGE.md](USAGE.md)。
**Claude Code** — 一个命令（`-s user` 为每个项目安装；删除它以仅限当前项目）：
```sh
claude mcp add xcloud -s user --env XCLOUD_API_TOKEN='your-xcloud-pat' -- npx -y @webnestify/xcloud-mcp@1.0.2
```
保持令牌周围的单引号 - xCloud PAT包含 `|`，如果不加引号，shell会将其视为管道。
**其他工具** （Claude Desktop、Codex CLI和任何其他支持MCP的工具） — 将服务器添加到您的代理的MCP配置中并设置您的令牌。大多数工具使用类似以下 `mcpServers` 块：
```json
{
"mcpServers": {
"xcloud": {
"command": "npx",
"args": ["-y", "@webnestify/xcloud-mcp@1.0.2"],
"env": { "XCLOUD_API_TOKEN": "your-xcloud-pat" }
}
}
}
```
固定版本（`@1.0.2`）意味着您始终运行已知版本，而不是最新版本。
> 更喜欢从源代码运行（用于开发或审计）？克隆存储库，构建它，并指向您的工具：
```sh
npm install && npm run build
```
```json
{
"mcpServers": {
"xcloud": {
"command": "node",
"args": ["/absolute/path/to/xcloud-mcp/dist/index.js"],
"env": { "XCLOUD_API_TOKEN": "your-xcloud-pat" }
}
}
}
```
重启您的代理，xCloud工具就会出现。要求它运行 `whoami` 以确认您的令牌的帐户和团队范围。
## 您能做什么
36种工具，按其更改程度分组：
- **25种读取工具。** 列出和检查服务器、站点、服务、防火墙规则、备份、日志、SSL、漏洞、WordPress状态等。默认可用。
- **7种安全写入工具。** 创建备份、运行扫描、清除缓存、应用WordPress更新、生成神奇登录链接。可逆或非破坏性，默认可用。
- **4种破坏性工具。** 重启服务器、重启服务、删除防火墙规则或cron作业。隐藏直到您选择启用，每个工具运行前都会询问。
完整的工具目录，包括每个工具的分类和所需的令牌范围，在 [FEATURES.md](FEATURES.md) 中。
## 文档
- **[USAGE.md](USAGE.md)** 涵盖环境变量、每个操作系统的凭证设置、示例客户端配置以及如何启用破坏性工具。
- **[FEATURES.md](FEATURES.md)** 是完整的工具目录，以及有意排除的内容及其原因。
- **[SECURITY.md](SECURITY.md)** 涵盖信任模型、机密处理、编辑保证、破坏操作门控以及如何报告漏洞。
## 状态
v1.0.2，已发布到npm - 按照快速入门指南使用 `npx` 安装。每个版本都带有签名构建出处和经认证的SPDX SBOM，您可以验证（参见 [SECURITY.md](SECURITY.md))。
## 关于 xCloud
[xCloud](https://xcloud.host/) 是一个第三方服务器和站点管理平台。这是用于公共xCloud REST API的独立、社区构建的MCP服务器，**不是** 官方xCloud产品，与xCloud无关联或背书。“xCloud”及相关标志属于其各自所有者。
## 许可证
[MIT](LICENSE) © Simon Gajdosik, Webnestify s.r.o.
