Neptune

Provides an MCP server that enables Neptune-based app deployment and IaC generation for AI agents.

typescript

15

GitHub Stars

typescript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "shuttle-hq-neptune-mcp": {
      "command": "neptune",
      "args": [
        "mcp"
      ]
    }
  }
}

Neptune MCP Server lets you manage app deployments for AI agents with built-in DevOps capabilities. It reads your project, infers needed infrastructure, and provides an inspectable, applyable IaC spec to ship safely to AWS using MCP workflows.

How to use

You use Neptune MCP Server by wiring it into your MCP client, then telling your agent to deploy or manage your app. Your MCP client communicates with the local Neptune MCP process or a remote MCP endpoint to orchestrate deployments. Neptune handles the IaC planning, approval, and applying changes, giving your agents real DevOps capabilities while keeping safeguards in place.

How to install

Prerequisites: You need a Unix-like shell or PowerShell for Windows. Ensure you have network access to install scripts when following these steps.

curl -LsSf https://neptune.dev/install.sh | bash

Windows (PowerShell):

irm https://neptune.dev/install.ps1 | iex

Configuration and usage notes

Configure Neptune MCP Server in your MCP client to enable the MCP connection. You provide a local or remote server entry, which the client uses to run the MCP workflow.

{
  "mcpServers": {
    "neptune": {
      "command": "neptune",
      "args": ["mcp"]
    }
  }
}

Local development and testing

To test changes locally, point the MCP config to your local Neptune MCP source and run the server via the development command shown below.

{
  "mcpServers": {
    "neptune": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/neptune-mcp",
        "neptune",
        "mcp"
      ]
    }
  }
}

Replace /path/to/neptune-mcp with the absolute path to your local clone.

## Verify the MCP server startup

After configuring for local development, verify that the MCP server starts correctly from the terminal.

uv run neptune mcp