# 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](https://github.com/modelcontextprotocol/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