Wrale MCP Server Make

🚀 MCP サーバー構築

このサーバーは、Model Context Protocol を通じて構築機能を提供し、LLM が Makefile に基づいて make ターゲットを安全かつ制御された方法で実行できるようにします。

🚀 クイックスタート

このサーバーは、Model Context Protocol を介して構築機能を提供し、LLM が以下のことを行えるようにします。

• 安全に make ターゲットを実行し、出力をキャプチャする
• 構築プロセスを理解し、ナビゲートする
• 開発タスクを支援する
• エラーを適切に処理する
• 作業ディレクトリのコンテキストを尊重する

📦 インストール

• uv を使用する場合（推奨）

uv pip install mcp-server-make

• pip を使用する場合

pip install mcp-server-make

📚 ドキュメント

基本的な使い方

# カレントディレクトリのデフォルト Makefile を使用
uvx mcp-server-make

# 特定の Makefile と作業ディレクトリを使用
uvx mcp-server-make --make-path /path/to/Makefile --working-dir /path/to/working/dir

MCP クライアントの設定

Claude Desktop で使用するには、Claude の設定ファイル（claude_desktop_config.json）に以下を追加します。

{
  "mcpServers": {
    "make": {
      "command": "uvx",
      "args": [
        "mcp-server-make",
        "--make-path", "/absolute/path/to/Makefile",
        "--working-dir", "/absolute/path/to/working/dir"
      ]
    }
  }
}

開発ワークフローの強化

このサーバーは、LLM に make 機能への直接アクセスを与えることで、強力な開発ワークフローを実現します。

開発者向け

1. 自動化支援
   • Claude にテスト結果を実行して説明させる
   • ビルドシステムの提案と改善を得る
   • 繰り返しの開発タスクを自動化する
   • 即時の変更フィードバックを得る
2. プロジェクト管理
   • Claude に依存関係の更新を処理させる
   • リリースプロセスを自動化する
   • 一貫したコード品質を維持する
   • プロジェクトの状態を追跡する

Claude 向け

1. 自己検証機能
   • 変更を検証するためにテストを実行する: make test
   • コード品質をチェックする: make lint
   • コードをフォーマットする: make format
   • 完全な検証を行う: make check
2. プロジェクト理解
   • プロジェクト構造を表示する: make x
   • 最近の変更をチェックする: make z
   • 完全なコンテキストスナップショットを取得する: make r
3. 独立した開発
   • 完全な開発サイクルを管理する
   • 自己完結型のテストと検証を行う
   • ビルドしてリリースの準備をする
   • 根拠のあるコミットメッセージを生成する

利用可能なツール

このサーバーは以下のツールを提供します。

• make - Makefile から make ターゲットを実行する
  • パラメータ
    • --make-path <パス>: 実行する Makefile のパスを指定します。デフォルトはカレントディレクトリの Makefile です。
    • --working-dir <パス>: 作業ディレクトリを設定し、コマンドの実行環境に影響を与えます。

エラー処理

• 指定された Makefile が見つからない場合、次の例外が発生します: FileNotFoundError: [Errno 2] No such file or directory: 'Makefile'
• make コマンドの実行中にエラーが発生した場合は、コンソール出力を確認して詳細を取得してください。

作業ディレクトリの動作

• サーバー起動時の作業ディレクトリのデフォルトはカレントディレクトリです。
• --working-dir パラメータを使用することで、作業ディレクトリを変更できます。

統合例

# 例: カスタム Makefile と作業ディレクトリを使用
uvx mcp-server-make --make-path ./custom_make/Makefile --working-dir ./workdir

トラブルシューティング

問題が発生した場合は、以下を確認してください。

• 指定された Makefile が存在することを確認する
• make コマンドを実行するのに十分な権限があることを確認する
• コンソール出力を確認してエラー情報を取得する

貢献ガイド

• 貢献する場合は、リポジトリをフォークしてプルリクエストを送信してください。
• コード規約とコミットガイドラインに従ってください。

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください。