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

Clone this repository:
```
git clone <repository-url>
cd mcpTAIGA
```
Install dependencies:
```
npm install
```

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:

authenticate - Authenticate with Taiga
listProjects - List all your Taiga projects
getProject - Get detailed information about a specific project
createUserStory - Create a new user story in a project
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