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

  1. Navigate to the Servers tab (your local library).
  2. Click the Add Server button (top right or center).
  3. 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.
  4. Environment Variables: Click "Add Var" to add API keys or configuration settings required by your script.
  5. Click Create Server.

Example: Running a Local Python Server

Name: Local Python Test
Command: uv
Arguments:
run
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.