Adding Custom Servers
Connect any local script or executable as an MCP server.
While the Marketplace has hundreds of pre-built servers, you may want to run a private script, a local development version, or a server not yet listed.
Steps to Add a Custom Server
- Navigate to the Servers tab (your local library).
- Click the Add Server button (top right or center).
- A dialog will appear with empty fields. Fill them in:
- Name: A display name (e.g., "My Python Script").
- Command: The executable (e.g., `python`, `uv`, `node`). Must be in your system PATH or an absolute path.
- Arguments: The script path and any flags (e.g., `main.py`, `--verbose`). Enter one argument per line.
- Environment Variables: Click "Add Var" to add API keys or configuration settings required by your script.
- Click Create Server.
Example: Running a Local Python Server
Name: Local Python Test
Command: uv
Arguments:
run
script.py
script.py
Troubleshooting
If your custom server fails to start, use the Logs feature (Terminal icon) to see the error output. Common issues include:
- Wrong file path (use absolute paths to be safe).
- Missing dependencies (run `npm install` or `pip install` in the server directory first).
- Typo in the command name.