内容
# MCP Starter
一个轻量级的 Go 应用程序,用于解析 JSON 配置文件并执行带有指定环境变量的命令。
## 特性
- 解析 JSON 配置文件
- 执行带有环境变量的命令
- 支持单服务器配置
- 跨平台(Linux、Windows、macOS)
## 安装
### 预构建的二进制文件
从 [Releases page](https://github.com/daniel-lxs/mcp-starter/releases) 下载适合您平台的最新版本。
### 从源代码构建
1. 确保您已安装 Go(版本 1.21 或更高)
2. 克隆代码库:
```bash
git clone https://github.com/daniel-lxs/mcp-starter.git
cd mcp-starter
```
3. 构建应用程序:
```bash
go build -o mcp-starter
```
**Windows 用户:** 为了防止在启动应用程序时出现终端窗口,请使用:
```powershell
go build -ldflags "-H=windowsgui" -o mcp-starter.exe
```
## 使用方法
1. 创建一个 JSON 配置文件(例如,`config.json`):
```json
{
"mcpServers": {
"MyServer": {
"command": "my-command",
"args": ["arg1", "arg2"],
"env": {
"MY_ENV_VAR": "value"
}
}
}
}
```
2. 准备命令以将其添加到 Cursor:
```bash
path/to/mcp-starter path/to/config.json
```
3. 将命令粘贴到 "Add MCP Server" 对话框中:

注意:使用可执行文件和配置文件的完整路径。
## 配置
JSON 配置文件必须包含一个服务器定义,结构如下:
```json
{
"mcpServers": {
"ServerName": {
"command": "command-to-execute",
"args": ["argument1", "argument2"],
"env": {
"ENV_VAR_NAME": "value"
}
}
}
}
```
- `command`:要执行的命令(必需)
- `args`:传递给命令的参数数组(可选)
- `env`:环境变量的键值对(可选)
## 开发
### 构建
要构建应用程序:
```bash
go build -o mcp-starter
```
请参阅 [Installation](#from-source) 部分以获取特定平台的构建说明。
### 测试
运行测试:
```bash
go test ./...
```
### 代码检查
运行代码检查工具:
```bash
golangci-lint run
```
## 贡献
欢迎贡献!请提出问题或提交拉取请求。
## 许可证
该项目根据 MIT 许可证授权 - 详情请参见 [LICENSE](LICENSE) 文件。
## Windows 用户
Windows 可执行文件未进行代码签名。要运行它:
1. 右键单击 .exe 文件
2. 选择 "属性"
3. 在常规选项卡下检查 "解除阻止"
4. 点击 "确定"
5. 运行可执行文件