What is Mcptaiga

mcpTAIGA is an MCP (Model Context Protocol) server designed to facilitate project management and user story creation in Taiga using natural language.

Use cases

Use cases for mcpTAIGA include managing software development projects, tracking user stories in agile workflows, and enhancing team collaboration through natural language interactions.

How to use

To use mcpTAIGA, clone the repository, install dependencies, configure your Taiga credentials in the .env file, and start the server using ‘npm start’. You can connect to the server using any MCP client.

Key features

Key features include listing all Taiga projects, retrieving detailed project information, creating user stories within a project, and listing user stories in a project.

Where to use

mcpTAIGA can be used in project management environments, particularly those utilizing Taiga for agile development and user story tracking.

Taiga MCP Server

An MCP (Model Context Protocol) server that allows you to interact with Taiga using natural language. This server enables you to list your projects and create user stories within your chosen project.

Features

• List all your Taiga projects
• Get detailed information about a specific project
• Create user stories within a project
• List user stories in a project

Prerequisites

• Node.js (v14 or higher)
• npm
• A Taiga account

Installation

1. Clone this repository:

   git clone <repository-url>
   cd mcpTAIGA
   

2. Install dependencies:

   npm install
   

3. Configure your Taiga credentials:

   Edit the .env file and add your Taiga credentials:

   TAIGA_API_URL=https://api.taiga.io/api/v1
   TAIGA_USERNAME=your_username
   TAIGA_PASSWORD=your_password
   #OPENAI_API_KEY=your_openai_api_key
   

Usage

Start the MCP server:

npm start

The server will start and listen for MCP requests via standard input/output.

If you don’t use Claude Desktop, Cursor, Windsurf or any client to use the MCP server, you can setup the OPENAI_API_KEY in .env file and execute:

node openaiClient.js

Connecting to the MCP Server

You can connect to the MCP server using any MCP client, such as the MCP Inspector or by using the MCP client SDK.

Available Tools

The server provides the following tools:

1. authenticate - Authenticate with Taiga
2. listProjects - List all your Taiga projects
3. getProject - Get detailed information about a specific project
4. createUserStory - Create a new user story in a project
5. listUserStories - List all user stories in a project

More coming soon…

Configuration example:

"taiga-mcp": {
      "command": "node",
      "args": ["C:\\path\\to\\mcpTAIGA\\src\\index.js"]
    }

With WSL:

"taiga-mcp": {
      "command": "wsl.exe",
      "args": [
        "bash",
        "-c",
        "cd /home/user/mcpTAIGA && /usr/bin/node src/index.js"
      ]
    }

Example Prompts

Here are some example natural language prompts you can use with an LLM that supports MCP:

• “List all my Taiga projects”
• “Show me details about project X”
• “Create a new user story in project Y with title ‘Implement login feature’”
• “Show me all user stories in project Z”

License

ISC