MCP Server Govbox

MCP Server Govbox

Govbox プロジェクトの Rakefile タスクと大規模言語モデル（LLM）の統合を容易にするために開発された MCP（Model Context Protocol）サーバーです。

📋 プロジェクトについて

このサーバーは LLM と Rake コマンドの橋渡し役となり、言語モデルが自動化されたタスクを安全かつ制御された方法で実行できるようにします。このプロジェクトは、Rake コマンドの実行を簡素化し、個々のコマンドについて事前知識がなくても利用できるように開発されました。

🎯 目的

主な目的は、LLM が次のことをできるようにすることです。

• Rakefile のタスクをプログラムから実行する
• 一般的なプロセスを自動化する
• Rake コマンドに関する専門知識の必要性を減らす
• タスクを実行するための標準化されたインターフェースを提供する

🚀 機能

• 安全かつ制御されたタスク実行
• 複数のプロジェクトに対応
• 標準化された結果の返却
• 堅牢なエラー処理

🛠️ 使用技術

• MCP サーバーに Go（Golang）を使用
• タスクの実行に Ruby/Rake を使用
• コンテナ化に Docker を使用

⚙️ インストールと設定

📦 ステップ 1：コードの取得

• リポジトリをクローンする

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

🔨 ステップ 2：ビルド

• Docker を使用する

docker build -t mcp-server-govbox .

• ローカルで実行する

go build cmd/app/main.go

🔧 ステップ 3：サーバーの設定

サーバーの設定には環境変数を使用します。サーバーを適切に動作させるには、すべての環境変数を設定する必要があります。まず、次の手順を実行します。

cp .env.example .env
# Edite o arquivo .env com suas configurações

必要な環境変数は次のとおりです。

• MCP_GOVBOX_PROJECT_PATH：Govbox プロジェクトディレクトリへのパス
• MCP_SHELL_PATH：コマンドの実行に使用するシェル（例：/bin/zsh）
• MCP_SHELL_OPTIONS：シェルに渡す追加の引数（例：-c）

重要な注意：.env ファイルは、サーバーを呼び出すクライアントプロジェクトのルートフォルダーに配置してください。たとえば、次のとおりです。

• Windows で Claude Desktop を使用する場合、ファイルは次の場所に配置してください：C:\Users\<Usuário>\AppData\Local\AnthropicClaude\app-<Versão>\.env
• 独自のクライアントを使用する場合は、クライアントのルートフォルダーに .env を配置してください

サーバーを起動する前に、.env ファイルですべての変数が正しく設定されていることを確認してください。

🔧 ステップ 4：クライアントの設定

このサーバーを Claude Desktop アプリケーションでクライアントとして使用するには、次の例に従って claude_desktop_config.json ファイルの設定を調整してください。

Docker を使用する場合

{
    "mcpServers": {
        "mcp-server-govbox": {
            "command": "docker",
            "args": [
                "run",
                "--rm",
                "-i",
                "mcp-server-govbox:latest"
            ]
        }
    }
}

実行可能ファイルを直接使用する場合

{
    "mcpServers": {
        "mcp-server-govbox": {
            "command": "/path/to/executable"
        }
    }
}

その他のクライアントでは、希望する設定をコピーし、使用する LLM クライアントのモデルに合わせて設定してください。

# Usando Docker
cp config_docker_example.json config.json
# OU para executável
cp config_executable_example.json config.json

❌ 発生する可能性のあるエラー

サーバーの実行中にエラーが発生する場合があり、その内容はクライアントに返されます。発生する可能性のあるエラーとその原因を以下に示します。

初期化エラー

• "Error loading .env file"：

  • .env ファイルが見つからない場合に発生します
  • または、ファイルの読み取り権限に問題がある場合に発生します
  • または、ファイルの書式が正しくない場合に発生します

• "Invalid shell configuration"：

  • シェルの環境変数が正しくない、または設定されていない場合に発生します
  • 考えられる原因：
    • MCP_GOVBOX_PROJECT_PATH が定義されていない、または空です
    • MCP_SHELL_PATH が定義されていない、または空です
    • 指定されたシェルがシステムに存在しません

検証エラー

• "Param 'projects' must be a string"：
  • リクエストにパラメーター 'projects' が指定されていない場合に発生します
  • または、指定された値が有効な文字列ではない場合に発生します

実行時エラー

• "Error during command execution (start)"：

  • コマンドの起動時に問題が発生した場合に表示されます
  • 考えられる原因：権限不足、シェルが見つからない、環境変数の設定ミス

• "Error during command execution (wait)"：

  • コマンドの実行中に問題が発生した場合に表示されます
  • 考えられる原因：コマンドが突然中断された、システムリソースの問題

• "Error creating stdout/stderr pipe"：

  • サーバーがコマンドの出力を取得するためのパイプを作成できない場合に表示されます
  • 考えられる原因：権限の問題、オペレーティングシステムの上限に達している

解決方法

1. .env ファイルですべての環境変数が正しく設定されていることを確認します
2. .env ファイルが正しい場所にあることを確認します
3. ユーザーに次の操作を行うための適切な権限があることを確認します
   • .env ファイルを読み取る
   • 設定されたシェルを実行する
   • Govbox プロジェクトのディレクトリにアクセスする
4. 設定されたシェルが存在し、アクセス可能であることを確認します
5. Govbox プロジェクトのパスが正しいことを確認します
6. エラーの詳細については、サーバーのログを確認します

📝 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。