# Hostman MCP Server (Experimental)

MCP server for automating application deployment to Hostman through the Model Context Protocol.

> **`IMPORTANT`** This project is experimental and may contain unstable functionality. Failures and incomplete features are possible. The server is designed without destructive operations, but it is still recommended to keep an eye on the actions it performs.

## Integration

### Cursor
[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=hostman-mcp-server&config=eyJjb21tYW5kIjoibnB4IEBob3N0bWFuL21jcC1zZXJ2ZXIiLCJlbnYiOnsiSE9TVE1BTl9UT0tFTiI6InlvdXItYXBpLXRva2VuIn19)

Or add it to Cursor settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "hostman-mcp-server": {
      "command": "npx",
      "args": ["@hostman/mcp-server"],
      "env": {
        "HOSTMAN_TOKEN": "your-api-token"
      }
    }
  }
}
```

### VS Code

[Add to VS Code](vscode:mcp/install?%7B%22hostman-mcp-server%22%3A%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40hostman%2Fmcp-server%22%5D%2C%22env%22%3A%7B%22HOSTMAN_TOKEN%22%3A%22your-api-token%22%7D%7D%7D), or add it to `.vscode/mcp.json`:

```json
{
  "mcp.servers": {
    "hostman-mcp-server": {
      "command": "npx",
      "args": ["@hostman/mcp-server"],
      "env": {
        "HOSTMAN_TOKEN": "your-api-token"
      }
    }
  }
}
```

## Tools

### `create_hostman_app`

Creates an application in Hostman with automatic detection of project parameters.

### `add_vcs_provider`

Adds a VCS provider for connecting Git repositories.

### `get_vcs_providers`

Returns the list of all VCS providers.

### `get_vcs_provider_repositories`

Returns the list of repositories for a given provider.

### `get_vcs_provider_by_repository_url`

Finds a VCS provider by repository URL.

### `get_allowed_presets`

Returns the list of available presets for creating an application.

### `get_deploy_settings`

Returns default deploy settings for various frameworks.

### `create_floating_ip`

Creates a new floating IP address in the specified availability zone.

### `create_vpc`

Creates a new virtual private cloud (VPC) in the specified availability zone.

### `create_database`

Creates a new database in Hostman with the specified parameters.

### `get_database_presets`

Returns the list of available preset configurations for creating databases.

## Prompts

### `create_app_prompt`

Helps create an application in Hostman with automatic detection of project parameters.

### `add_vcs_provider_prompt`

Helps add a VCS provider for connecting a repository.

## Usage

Run the prompts, or simply say something like: "Deploy my app to Hostman" — the server will automatically detect the application type and framework and create it in Hostman.

## Important

After creating an application you must manually configure environment variables in the Hostman control panel, since the chatbot does not have access to your project's `.env` file.