MCP 服务器 Govbox

一个用于简化大型语言模型 (LLMs) 和 Rakefile 任务集成的 Model Context Protocol (MCP) 服务器。

📋 项目概述

该服务器作为 LLMs 和 Rake 命令之间的桥梁，使模型能够执行自动化任务。该项目旨在降低使用 Rake 命令的知识门槛。

🎯 目标

主要目标是让 LLMs 能够：

• 执行 Rakefile 任务
• 自动化常见流程
• 减少对具体命令的了解需求
• 提供统一的任务执行接口

🚀 功能

• 安全受控的任务执行
• 支持多个项目
• 标准结果返回
• 强健的错误处理

🛠️ 使用的技术

• Go（Golang）用于服务器 MCP
• Ruby/Rake 用于任务执行
• Docker 用于容器化

⚙️ 安装与配置

📦 第一步：获取代码

git clone https://github.com/giovanoh/mcp-server-govbox.git
cd mcp-server-govbox

🔨 第二步：构建 Docker 镜像（可选）

# 使用一个基础的 Go 容器来构建 MCP 服务器
FROM golang:1.20 AS builder

WORKDIR /app

COPY go.mod .
RUN go mod tidy

COPY . .

CMD ["go", "run", "./main.go"]

# 创建一个轻量的基础镜像运行 MCP 服务器
FROM alpine:3.18

WORKDIR /app

COPY --from=builder /app/main .

EXPOSE 8080

CMD ["/app/main"]

🔧 第三步：启动服务器

# 在本地构建并运行
go run main.go

# 使用 Docker 运行（如果已构建镜像）
docker build -t mcp-server .
docker run -p 8080:8080 mcp-server

🎯 环境变量配置

在 main.go 同级目录创建 .env 文件：

echo "MCP_GOVBOX_PROJECT_PATH=/path/to/govbox-project" > .env
echo "MCP_SHELL_PATH=/bin/bash" >> .env

📝 错误处理

初始化错误

• 无效shell配置：检查 .env 中的 MCP_SHELL_PATH 和 MCP_GOVBOX_PROJECT_PATH 是否正确。

运行时错误

• 任务执行失败：确保 Rake 命令有足够权限，并且 Govbox 项目路径存在。

📝 许可证

本项目使用 MIT License。