内容
# ukraine.com.ua MCP
[](https://github.com/sanyo4ever/ukraine.com.ua-mcp/actions/workflows/ci.yml)
[](LICENSE)
[](package.json)
用于 adm.tools / ukraine.com.ua 主机的模型上下文协议（MCP）服务器。它允许 AI 助手和 MCP 客户端发现并调用 ukraine.com.ua API 中记录的动作，用于主机、DNS、域名、邮件、数据库、VPS、存储和计费自动化。
此仓库仅包含 MCP 服务器运行时和公共端点元数据。
## 为什么存在
- 使用 ukraine.com.ua / adm.tools 的 MCP 兼容客户端。
- 搜索生成的包含 679 个记录的 adm.tools API 动作目录。
- 通过一个通用目录工具调用记录的动作。
- 为 adm.tools API 路径、方法和参数提供公共参考。
- 为 AI 代理提供更安全、更有类型的接口，用于主机操作。
相关搜索：`ukraine.com.ua API`，`adm.tools API`，`admtools MCP`，`ukraine.com.ua 主机自动化`，`模型上下文协议主机`，`MCP 服务器 DNS 主机`。
## 当前工具
- `adm_get_services`：通过 `POST https://adm.tools/action/get_services/` 读取服务库存。
- `adm_hosting_accounts`：通过 `GET https://adm.tools/action/hosting/account/list/` 读取主机账户库存。
- `adm_hosting_sites`：通过 `POST https://adm.tools/action/hosting/virtual/list/` 读取站点/子域名库存。
- `adm_hosting_webapp_info`：通过 `POST https://adm.tools/action/hosting/account/app/systemd/info/` 读取 Web 应用进程/启动命令信息。
- `adm_api_catalog_search`：搜索生成的完整 API 目录。
- `adm_api_action_info`：检查生成的某一个记录动作的元数据。
- `adm_api_call`：通过生成的目录调用任何记录的动作。
- `adm_api_raw`：对 `https://adm.tools/action/{action}/` 的高级原始调用。
## 代理使用案例
- 清点主机账户、站点、域名、邮件、数据库、VPS 和存储。
- 在调用 adm.tools API 动作之前检查可用的动作。
- 从 Claude Desktop、Cursor、Codex 或任何 MCP 兼容客户端自动执行 DNS 和主机工作流程。
- 使用特定的只读辅助工具进行常见主机库存检查。
- 当动作有记录但尚不存在自定义 MCP 助手时，使用通用目录工具。
## API 目录
生成的公共目录可在 [`docs/api-catalog.generated.md`](docs/api-catalog.generated.md) 中找到。
当前目录覆盖范围：
- 679 个记录的动作。
- 633 个 POST 动作和 46 个 GET 动作。
- 1551 个记录的参数。
- 主要组包括主机、DNS、域名、邮件、MySQL、PostgreSQL、Redis、VPS、存储、计费和专用服务器。
## 设置
```sh
npm install
cp .env.example .env
```
设置一个本地令牌变量：
```sh
ADMTOOLS_API_TOKEN=...
```
`UKRAINE_COM_UA_API_TOKEN` 也被接受为兼容性回退。
在本地运行：
```sh
npm run build
npm run dev
```
## MCP 客户端配置
```json
{
"mcpServers": {
"ukraine-com-ua": {
"command": "node",
"args": ["/absolute/path/to/ukraine.com.ua-mcp/dist/index.js"],
"env": {
"ADMTOOLS_API_TOKEN": "your-token"
}
}
}
}
```
## 安全
- 仅通过环境变量提供令牌。
- 不要提交 `.env` 或本地凭证。
- 优先使用只读辅助工具进行库存和发现任务。
