Prerequisites
- Python 3.13+ installed
- uv package manager
- macOS
- Linux
- Windows
Option 1: STDIO Transport (Recommended)
Most MCP clients use STDIO transport, where the client spawns the MCP server as a subprocess and communicates via stdin/stdout.The Command
Configuration Format
Most clients use a JSON configuration like this:- macOS / Linux
- Windows
On Windows, you need to wrap the command with
cmd /c because most MCP clients can’t directly execute uvx.Where to Put This Configuration
Option 2: HTTP Transport
If your client doesn’t support STDIO, or you prefer HTTP, you can run the Neptune MCP as an HTTP server.Start the Server
http://localhost:8001/mcp by default.
Connect Your Client
Configure your MCP client to connect to:Custom Port
To use a different port:Available Tools
Once connected, your AI assistant has access to these Neptune tools:Troubleshooting
'uvx: command not found'
'uvx: command not found'
Make sure If not found, reinstall uv and restart your terminal/shell.
uv is installed and in your PATH:Python version error
Python version error
Neptune MCP requires Python 3.13+. Check your version:If needed, install Python 3.13+ from python.org.
MCP server fails to start
MCP server fails to start
Try running the command manually in your terminal to see error messages:Press
Ctrl+C to stop.HTTP server connection refused
HTTP server connection refused
- Make sure the HTTP server is running before connecting
- Check if something else is using port 8001
- Try a different port with
--port=9000
Windows: Command not working
Windows: Command not working
On Windows, always wrap with
cmd /c: