taiga-mcp/README.md

MCP server for interacting with Taiga using natural language

# Taiga MCP Server

An MCP (Model Context Protocol) server that allows you to interact with Taiga using natural language via Claude or other MCP-compatible AI assistants. This server enables you to list your projects, create user stories, add tasks, and more.

## Features

- Authenticate with Taiga
- List all your Taiga projects
- Get detailed information about a specific project
- Create user stories within a project
- List user stories in a project
- Create tasks within user stories
- Interact with Taiga using natural language through Claude

## Prerequisites

- Node.js (v16 or higher)
- npm
- A Taiga account

## Installation

### Using npx (recommended)

The easiest way to use the Taiga MCP server is directly with npx:

```bash
npx taigamcp
```

This will download and run the latest version of the server.

### From npm

You can also install the package globally:

```bash
npm install -g taigamcp
```

Then run it:

```bash
taigamcp
```

### From source

1. Clone this repository:
   ```bash
   git clone <repository-url>
   cd mcpTAIGA
   ```

2. Install dependencies:
   ```bash
   npm install
   ```

3. Run the server:
   ```bash
   npm start
   ```

## Configuration

Create a `.env` file with your Taiga credentials:

```
TAIGA_API_URL=https://api.taiga.io/api/v1
TAIGA_USERNAME=your_username
TAIGA_PASSWORD=your_password
```

You can also pass these credentials directly when using the authenticate tool.

## Claude Desktop Configuration

To add this server to Claude Desktop, update your `claude_desktop_config.json` with:

```json
"taiga-mcp": {
  "command": "npx",
  "args": ["-y", "taigamcp"]
}
```

For WSL users:

```json
"taiga-mcp": {
  "command": "wsl.exe",
  "args": [
    "bash",
    "-c",
    "/usr/bin/npx -y taigamcp"
  ]
}
```

## 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
6. `createTask` - Create a new task within a user story

## Example Prompts for Claude

Here are some example natural language prompts you can use with Claude:

- "Authenticate with Taiga using my credentials"
- "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"
- "Add a task to user story #123 with the title 'Create API endpoint'"

## Testing

For direct testing without Claude, you can use the included test clients:

```bash
node testClient.js
```

or

```bash
node testDirectClient.js
```

## License

ISC