A lightweight Go application that parses JSON configuration files and executes commands with specified environment variables.
- Parses JSON configuration files
- Executes commands with environment variables
- Supports single server configuration
- Cross-platform (Linux, Windows, macOS)
Download the latest release for your platform from the Releases page.
-
Ensure you have Go installed (version 1.21 or higher)
-
Clone the repository:
git clone https://github.com/daniel-lxs/mcp-starter.git cd mcp-starter -
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
-
Create a JSON configuration file (e.g.,
config.json):{ "mcpServers": { "MyServer": { "command": "my-command", "args": ["arg1", "arg2"], "env": { "MY_ENV_VAR": "value" } } } } -
Prepare the command to add it to Cursor:
path/to/mcp-starter path/to/config.json
-
Paste the command into the "Add MCP Server dialog:
Note: Use the full path to the executable and the config file.
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)
To build the application:
go build -o mcp-starterSee Installation section for platform-specific build instructions.
Run the tests:
go test ./...Run the linter:
golangci-lint runContributions are welcome! Please open an issue or submit a pull request.
This project is licensed under the MIT License - see the LICENSE file for details.
The Windows executable is not code-signed. To run it:
- Right-click the .exe file
- Select "Properties"
- Check "Unblock" under the General tab
- Click "OK"
- Run the executable