使用说明

项目简介

Hostinger API MCP Server 是一个实现了 Model Context Protocol (MCP) 协议的服务器，它将 Hostinger API 提供的各项云服务管理功能，例如 VPS 管理、DNS 管理、账单管理等，封装成一系列工具 (Tools)，以便能够被兼容 MCP 协议的 LLM 客户端（如 Claude.js 等）调用。通过此服务器，LLM 可以安全、可扩展地与 Hostinger 云服务进行交互，实现自动化管理和操作。

主要功能点

工具 (Tools) 提供: 将 Hostinger API 的众多功能（例如创建/管理 VPS、DNS 记录、账单操作等）转化为可被 LLM 调用的工具。
资源 (Resources) 管理: 虽然仓库信息中没有明确提及资源管理，但通过工具可以间接访问和操作 Hostinger 的云资源，例如 VPS 实例、域名等。
Prompt 模板 (Prompts): 仓库中没有直接体现 Prompt 模板功能，但作为 MCP 服务器，理论上可以扩展支持 Prompt 模板的定义和渲染，以支持更定制化的 LLM 交互模式 (当前版本未明确实现)。
JSON-RPC 通信: 基于 JSON-RPC 协议与 MCP 客户端进行通信，接收请求并返回响应。
Stdio 传输协议: 使用 Stdio 作为默认的传输协议，方便集成和部署。
会话管理和能力声明: MCP 服务器端负责会话管理和声明自身提供的能力，当前实现主要声明了工具 (tools) 能力。
安全性: 通过 API Token 进行身份验证，保障 API 调用的安全性。

安装步骤

安装 Node.js: 确保您的系统已安装 Node.js v20 或更高版本。推荐使用 NVM (Node Version Manager) 管理 Node.js 版本。
- 访问 Node.js 官网下载安装，或使用包管理器如 Homebrew (macOS) 或 Chocolatey (Windows)。
- 如果使用 NVM，请执行以下命令安装 Node.js v20:
```
nvm install v20
nvm use v20
```

安装 MCP Server: 使用 npm, yarn 或 pnpm 全局安装 'hostinger-api-mcp':

npm install -g hostinger-api-mcp
# 或
yarn global add hostinger-api-mcp
# 或
pnpm add -g hostinger-api-mcp

服务器配置

对于 MCP 客户端，您需要配置 MCP 服务器的连接信息。以下是一个 JSON 格式的配置示例，适用于 Claude、Cursor 等 MCP 客户端：

{
    "mcpServers": {
        "hostinger-api": {  // 服务器名称，可以自定义
            "command": "hostinger-api-mcp", // 启动服务器的命令
            "env": {
                "DEBUG": "false", // 是否启用 Debug 日志，可选 "true" 或 "false"，默认为 "false"
                "APITOKEN": "YOUR API TOKEN" // 您的 Hostinger API Token，**必填**
            }
        }
    }
}

配置参数说明:

'server name': MCP 服务器的名称，客户端用于标识和引用，可以自定义。例如 '"hostinger-api"'。
'command': 启动 MCP 服务器的命令，通常为已全局安装的包名。此处为 '"hostinger-api-mcp"'。
'env': 环境变量配置，传递给 MCP 服务器进程。
- 'DEBUG': 控制是否启用 Debug 日志输出， '"true"' 启用， '"false"' 关闭。
- 'APITOKEN': 必需配置，您的 Hostinger API Token，用于 API 请求的身份验证。请替换 '"YOUR API TOKEN"' 为您实际的 API Token。

注意: 请务必将 '"YOUR API TOKEN"' 替换为您真实的 Hostinger API Token，否则服务器将无法正常访问 Hostinger API。

基本使用方法

启动 MCP Server: 全局安装后，MCP 服务器可以通过命令 'hostinger-api-mcp' 直接在终端中启动。但通常 MCP 客户端会自动根据配置启动服务器。
配置 MCP 客户端: 在您的 MCP 客户端 (例如 Claude.js 客户端) 中，配置上述 JSON 格式的服务器连接信息。
连接到 MCP Server: 客户端根据配置信息，通过 Stdio 传输协议与 MCP 服务器建立连接。
列出可用工具: 客户端可以发送 'ListTools' 请求到 MCP 服务器，获取服务器提供的工具列表。
调用工具: 客户端可以使用 'CallTool' 请求调用特定的工具，并传递工具所需的参数。服务器将执行相应的 Hostinger API 调用，并将结果返回给客户端。

Claude.js 客户端示例 (参考 README.md):

import { MCP } from "claude-js";
import { createStdio } from "claude-js/mcp";

// 创建 Stdio 传输
const transport = createStdio({ command: "hostinger-api-mcp" });

// 连接到 MCP 服务器
const mcp = new MCP({ transport });
await mcp.connect();

// 列出可用工具
const { tools } = await mcp.listTools();
console.log("Available tools:", tools);

// 调用工具 (示例)
const result = await mcp.callTool({
    id: "TOOL-ID", // 工具 ID，从 ListTools 响应中获取
    arguments: { param1: "value1" } // 工具参数，根据工具定义
});
console.log("Tool result:", result);

请根据实际需要，参考 'README.md' 中提供的 "Available Tools" 列表，选择合适的工具并传递正确的参数进行调用。

Hostinger API MCP Server