gotask-mcp

gotask-mcp

Taskfile/go-task 用の Model Context Protocol（MCP）サーバーです。

前提条件

このプロジェクトと mcp CLI を使用するには、依存関係管理ツール uv がインストールされている必要があります。Homebrew をお使いの場合は、たとえば brew install uv でインストールできます。他の方法はこちらをご覧ください。

Taskfile もインストールする必要があります。Homebrew をお使いの場合は、brew install go-task でインストールできます。 他の方法はこちらをご覧ください。

Cursor IDE のクイックスタート

0. 前提条件を満たしていることを確認します
1. このリポジトリをクローンします
2. 作業中のプロジェクトに適切な Taskfile.yml があることを確認します（このプロジェクトの例を参考にできます）
3. Cursor の設定 > MCP Servers で、次のコマンドを使ってサーバーを起動します。

uv run --with mcp --directory /path/to/gotask-mcp mcp run /path/to/gotask-mcp/src/server.py

.cursor/rules/tool-use-rule.mdc にあるコンテキストルールを作業中のプロジェクトにコピーする（または同様のルールを作成する）ことをおすすめします。Cursor Agent がツールを適切に使うには、指示が必要です。

詳細

タスクランナー（Taskfile など）は、定期的に必要となる単純または複雑な作業のための短いコマンドを定義し、実行する手段です。

こうしたタスクは、たとえば自動修正や QA チェックなど、開発サイクルの重要な一部となることがあります。そのため、生成 AI を搭載したコーディングエージェントが適切なタイミングでこれらのタスクを実行できると便利です。これを実現する方法が、そのようなタスクを実行するツールを提供する MCP サーバーです。

このサーバーは、隔離された環境で動作し、作業中のプロジェクトに関するコンテキスト情報をクライアントから渡されるように設計されています（Cursor IDE Agent でテスト済みです）。

1. 利用可能なタスクの一覧を取得するツール
2. 名前を指定してタスクを実行するツール

Cursor Agent は、これらのツールの入力として作業ディレクトリのパスを渡すことが想定されています。これにより、ツールはプロジェクトの Taskfile.yml を読み取れます。

(注：執筆時点では、MCP リソースは Cursor IDE であまりうまく動作しません。最初のツールは本来、ツールではなくリソースとして実装するのが理想です)