MCP Server Govbox

🚀 MCP 服務器 Govbox

MCP 服務器 Govbox 是一個用於簡化大型語言模型 (LLMs) 和 Rakefile 任務集成的工具。它作為兩者之間的橋樑，讓模型能夠輕鬆執行自動化任務，降低了使用 Rake 命令的知識門檻。

🚀 快速開始

MCP 服務器 Govbox 作為 LLMs 和 Rake 命令之間的橋樑，可使模型執行自動化任務。以下是快速搭建該服務器的步驟。

第一步：獲取代碼

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

✨ 主要特性

• 安全受控的任務執行：保障任務執行過程的安全性和可控性。
• 支持多個項目：可同時為多個項目提供服務。
• 標準結果返回：統一返回結果的格式，便於處理。
• 強健的錯誤處理：能夠有效處理各種初始化和運行時錯誤。

📦 安裝指南

第一步：獲取代碼

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

📚 詳細文檔

項目概述

該服務器作為 LLMs 和 Rake 命令之間的橋樑，使模型能夠執行自動化任務。該項目旨在降低使用 Rake 命令的知識門檻。

目標

主要目標是讓 LLMs 能夠：

• 執行 Rakefile 任務
• 自動化常見流程
• 減少對具體命令的瞭解需求
• 提供統一的任務執行接口

技術使用

🔧 技術細節

錯誤處理

初始化錯誤

• 無效shell配置：檢查 .env 中的 MCP_SHELL_PATH 和 MCP_GOVBOX_PROJECT_PATH 是否正確。

運行時錯誤

• 任務執行失敗：確保 Rake 命令有足夠權限，並且 Govbox 項目路徑存在。

📄 許可證

本項目使用 MIT License。