MCP Starter

A lightweight Go application that parses JSON configuration files and executes commands with specified environment variables.

Features

• Parses JSON configuration files
• Executes commands with environment variables
• Supports single server configuration
• Cross-platform (Linux, Windows, macOS)

Installation

Pre-built Binaries

Download the latest release for your platform from the Releases page.

From Source

1. Ensure you have Go installed (version 1.21 or higher)

2. Clone the repository:

   git clone https://github.com/daniel-lxs/mcp-starter.git
   cd mcp-starter
   

3. Build the application:

   go build -o mcp-starter
   

   Windows Users: To prevent terminal windows from appearing when the application is launched, use:

   go build -ldflags "-H=windowsgui" -o mcp-starter.exe
   

Usage

1. Create a JSON configuration file (e.g., config.json):

   {
     "mcpServers": {
       "MyServer": {
         "command": "my-command",
         "args": ["arg1", "arg2"],
         "env": {
           "MY_ENV_VAR": "value"
         }
       }
     }
   }
   

2. Prepare the command to add it to Cursor:

   path/to/mcp-starter path/to/config.json
   

3. Paste the command into the "Add MCP Server dialog:

Note: Use the full path to the executable and the config file.

Configuration

The JSON configuration file must contain exactly one server definition with the following structure:

{
  "mcpServers": {
    "ServerName": {
      "command": "command-to-execute",
      "args": ["argument1", "argument2"],
      "env": {
        "ENV_VAR_NAME": "value"
      }
    }
  }
}

• command: The command to execute (required)
• args: Array of arguments to pass to the command (optional)
• env: Key-value pairs of environment variables (optional)

Development

Building

To build the application:

go build -o mcp-starter

See Installation section for platform-specific build instructions.

Testing

Run the tests:

go test ./...

Linting

Run the linter:

golangci-lint run

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Windows Users

The Windows executable is not code-signed. To run it:

1. Right-click the .exe file
2. Select “Properties”
3. Check “Unblock” under the General tab
4. Click “OK”
5. Run the executable