mcpField
G
gotask-mcp

gotask-mcp

Local
github.com/PaddyAltonDeveloper Tools4Updated 84w ago
Repository

About gotask-mcp

gotask-mcp is an MCP server for Taskfile and go-task, aimed at coding agents that need to run project tasks. It exposes tools to list available tasks and run a named task using the working directory provided by the client.

Key features

  1. 01List available Taskfile tasks
  2. 02Run a named task
  3. 03Use client-provided working directory

Use cases

  1. 01Inspect a project's available tasks
  2. 02Run project autofixes through an agent
  3. 03Run QA checks during development

MCP support

The MCP server exposes tools to list tasks and run a selected task. The client supplies the working directory so the server can read that project's Taskfile.yml.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

gotask-mcp

A Model Context Protocol (MCP) Server for Taskfile/go-task.

Prerequisites

This project and the mcp CLI rely on your having the dependency management tool uv installed. You can install via e.g. brew install uv for Homebrew users. See here for alternatives.

You will also need to have Taskfile installed. brew install go-task will work if you are a Homebrew user. See here for alternatives.

Quickstart for Cursor IDE

  1. ensure you have the prerequisites installed
  2. clone down this repository
  3. ensure you have a suitable Taskfile.yml in your working project (you can use the example in this project for inspiration)
  4. in Cursor settings > MCP Servers, start a server with the following command:

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

It is recommended to copy the contextual rule in .cursor/rules/tool-use-rule.mdc into your working project (or write a similar rule). The Cursor Agent will need some instructions if it is to use the tools properly.

Details

A task runner (such as Taskfile) is a means of defining and running short commands that do regularly required, simple or complex work.

Such tasks can be an important part of the development cycle, for example autofixes and QA checks. Therefore it would seem useful if coding agents powered by generative AI could run these tasks at the appropriate time. The way to achieve this is with an MCP server that provides tools for running such tasks.

The server is designed to run in an isolated environment and to have contextual information about the working project passed in by the Client (tested with Cursor IDE Agent)

  1. a tool to retrieve a list of available tasks
  2. a tool to run a named task

The Cursor Agent is expected to pass in the working directory path as an input to these tools, which allows the tools to read the project Taskfile.yml.

(N.B. at the time of writing MCP resources don't work very well with Cursor IDE - the first tool would ideally be implemented as a resource, not a tool)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.