gotask-mcp logo

gotask-mcp

by PaddyAlton

gotask-mcp is a Model Context Protocol (MCP) Server designed for use with Taskfile/`go-task`. It enables coding agents powered by generative AI to run tasks defined in Taskfile.

View on GitHub

Last updated: N/A

What is gotask-mcp?

This is an MCP server that provides tools for running tasks defined in a Taskfile, allowing coding agents to automate development cycle tasks like autofixes and QA checks. It's designed to run in an isolated environment and receive contextual information about the working project from the client.

How to use gotask-mcp?

  1. Ensure you have uv and Taskfile installed. 2. Clone the repository. 3. Have a Taskfile.yml in your working project. 4. In Cursor settings, start an MCP server with the command: uv run --with mcp --directory /path/to/gotask-mcp mcp run /path/to/gotask-mcp/src/server.py. 5. Copy the contextual rule in .cursor/rules/tool-use-rule.mdc into your working project.

Key features of gotask-mcp

  • Retrieves a list of available tasks

  • Runs a named task

  • Designed for integration with coding agents

  • Uses MCP to provide task execution capabilities

  • Supports Taskfile.yml

Use cases of gotask-mcp

  • Automating autofixes

  • Running QA checks

  • Integrating task execution into AI-powered coding workflows

  • Enabling Cursor IDE Agent to execute tasks

  • Automating repetitive development tasks

FAQ from gotask-mcp

What is Taskfile?

Taskfile is a task runner that allows you to define and run short commands.

What is MCP?

MCP stands for Model Context Protocol, a protocol for communication between coding agents and servers.

What prerequisites are needed?

You need uv and Taskfile installed.

How do I install uv?

You can install uv using brew install uv or other methods described in the uv documentation.

How does the Cursor Agent use this server?

The Cursor Agent passes the working directory path as an input to the tools, allowing them to read the project's Taskfile.yml.