# MCP DigitalOcean

A Model Context Protocol (MCP) server for deploying and managing static websites on DigitalOcean App Platform.

## Project Structure

```
src/
├── index.ts              # Main entry point
├── shared/               # Shared utilities
│   └── api.ts            # Shared API utilities
├── digitalocean/         # DigitalOcean MCP server
│   ├── api.ts            # DigitalOcean API functions
│   ├── server.ts         # DigitalOcean MCP server configuration
│   └── types.ts          # DigitalOcean API types
└── template/             # Template for new MCP servers
    ├── api.ts            # Template API functions
    ├── server.ts         # Template MCP server configuration
    └── types.ts          # Template API types
tests/                    # Test scripts and files
```

## Available MCP Server

### DigitalOcean Server

The DigitalOcean MCP server provides tools for deploying and managing static websites on DigitalOcean App Platform using their API.

#### API Token Handling

The DigitalOcean MCP server will automatically look for your API token in the following locations (in order):

1. As a parameter in the tool call
2. Environment variables: `DO_API_TOKEN` or `DIGITALOCEAN_API_TOKEN`
3. A file at `~/.dotoken` containing just the token
4. A `.env` file in the project root with `DO_API_TOKEN=your_token`
5. A file at `~/.config/digitalocean/token` containing just the token

This means you can set up your token once and not have to provide it with every command.

#### Tools:

- **deploy-static-site**: Deploy a static website to DigitalOcean App Platform
  - Required Parameters:
    - `app_name`: Name for your app
    - `repo`: GitHub repository (username/repo)
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)
    - `region`: Region code (e.g., nyc, sfo) - Default: "nyc"
    - `branch`: Branch to deploy - Default: "main"
    - `source_dir`: Directory in repo containing source code - Default: "/"
    - `build_command`: Build command (if needed)
    - `output_dir`: Directory where build outputs files
    - `deploy_on_push`: Auto-deploy on git push - Default: true
    - `environment_slug`: Runtime environment - Default: "html"
    - `custom_domain`: Custom domain (optional)

- **get-app-info**: Get information about a DigitalOcean App Platform app
  - Required Parameters:
    - `app_id`: App ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)

- **get-deployment-status**: Get the status of a specific deployment
  - Required Parameters:
    - `app_id`: App ID
    - `deployment_id`: Deployment ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)

- **list-deployments**: List all deployments for an app
  - Required Parameters:
    - `app_id`: App ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)

- **create-deployment**: Create a new deployment (redeploy an app)
  - Required Parameters:
    - `app_id`: App ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)
    - `force_build`: Force a rebuild without cache - Default: false

- **get-deployment-logs**: Get logs for a deployment
  - Required Parameters:
    - `app_id`: App ID
    - `deployment_id`: Deployment ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)

- **delete-app**: Delete an app from DigitalOcean App Platform
  - Required Parameters:
    - `app_id`: App ID
  - Optional Parameters:
    - `token`: DigitalOcean API token (optional if stored in environment or config files)

## Adding a New MCP Server

To add a new MCP server:

1. Copy the `template` directory and rename it to your server name
2. Update the types, API functions, and server configuration
3. Add your server to the main `index.ts` file

## Building and Running

```bash
# Install dependencies
npm install

# Build the project
npm run build

# Run the DigitalOcean MCP server
node build/index.js
```

## Testing

The project includes several test scripts in the `tests/` directory:

- `test-simple.mjs`: A simple test script that sends JSON-RPC requests to the MCP server
- `test-api.mjs`: A script that directly tests the DigitalOcean API
- `test-mcp.mjs`: A more comprehensive test for the MCP server
- `test-deploy.mjs`: A test script specifically for the deploy-static-site tool
- `token-test.mjs`: A utility script to verify that the DigitalOcean API token can be read correctly

To run a test:

```bash
# Run a test script
node tests/test-simple.mjs
```

## Cursor Integration

To use with Cursor, add the following to your `.cursor/mcp.json` file:

```json
{
  "mcpServers": {
    "digitalocean": {
      "command": "node",
      "args": [
        "/path/to/your/project/build/index.js"
      ]
    }
  }
}
```