Ploi MCP Server

An MCP (Model Context Protocol) server implementation for Ploi.io hosting platform.

Overview

This server exposes Ploi.io API functionality as MCP tools that can be used by AI agents to manage servers, sites, databases, and execute scripts.

Features

• Server management (list, get, status, restart)
• Site management (list, get, deploy, deployment status)
• Script execution on servers
• Database operations (list, create, backup)

Prerequisites

1. Node.js >= 18.0.0
2. A Ploi.io account with API access
3. An API token stored in macOS keychain:

   security add-generic-password -s ploi-api-token -a $USER -w YOUR_API_TOKEN
   

Installation

npm install
npm run build

Usage

The server can be run directly:

node dist/index.js

Testing

Test the server by sending a JSON-RPC request:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js

Integration

To integrate with OpenClaw, add this to your openclaw.json:

{
  "ploi-mcp": {
    "command": "node",
    "args": ["~/.openclaw/workspace/skills/ploi-mcp/dist/index.js"],
    "env": {
      "PLOI_API_KEY": "{{keychain:ploi-api-token}}"
    }
  }
}

Project Structure

ploi-mcp/
├── src/
│   ├── index.ts          # Main entry point
│   ├── ploi-client.ts    # API client wrapper
│   ├── tools/            # Tool type definitions
│   │   └── index.ts
├── dist/                 # Compiled output
├── package.json
├── tsconfig.json
├── SKILL.md              # Documentation
└── README.md             # This file

Development

To develop and test changes:

1. Make changes to TypeScript files in src/
2. Compile with npm run build
3. Test with echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js