Tuleap MCP

Model Context Protocol (MCP) server for Tuleap projects.

Installation

Prerequisite: You need to have Node.js (v16 or later) and npm installed.

1. Clone the repository:

   git clone <repository-url>
   cd tuleap-mcp
   

2. Install dependencies:

   npm install
   

3. Configure your Tuleap credentials by copying .env.example to .env and filling in the required values.

4. Run npm run build to generate the dist/index.js file.

Tools

Run the dev server:

npm run dev

Available Tools

| Tool Name | Description | Parameters | | ---------------- | ----------------------------------------------------------- | ----------------------------------------- | | get-current-user | Get information about the currently authenticated user | None | | get-projects | Get a list of projects the authenticated user has access to | None | | get-trackers | Get trackers for a specific project | projectId (int) | | get-artifacts | Get artifacts from a specific tracker | trackerId (int), limit (int, default: 50) | | get-artifact | Get details from a specific artifact | artifactId (int), with_comments (bool) | | get-artifact-changes | Get the history of changes (changesets) for a specific artifact | artifactId (int) |

Configuration

Example mcp.json configuration:

{
  "mcpServers": {
    "tuleap-mcp": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/tuleap-mcp/dist/index.js"],
      "cwd": "/path/to/tuleap-mcp"
    }
  }
}

For OpenCode, example .config/opencode/config.json configuration :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tuleap-mcp": {
      "type": "local",
      "command": [
        "node",
        "/path/to/tuleap-mcp/dist/index.js"
      ],
      "enabled": true
    }
  }
}

MCP Inspector

To run with MCP inspector during development:

npm run dev:inspector

Or for automatic reloading:

npm run dev

Dependencies

• @modelcontextprotocol/sdk - MCP SDK for Node.js
• dotenv - Environment variable management
• zod - Type validation and schema declaration

Build

To build the TypeScript code to JavaScript:

npm run build

Start Production Server

npm start