X-MCP: Product-X Test Management MCP Server

X-MCP is a Model Context Protocol (MCP) server that provides comprehensive test case management capabilities for the Product-X Test Management System. It allows you to manage test cases, modules, components, and subcomponents directly from Cursor, VS Code, or any MCP-compatible client.

Quick links: Install from npm · Run from source · All tools

Features

• x-test-planner agent: Standard, repeatable test planning via an MCP prompt that uses embedded context (no manual context file required)
• Module Management: Create, update, delete, and list modules, components, and subcomponents
• Test Case Management: Full CRUD operations for test cases
• Test Case Operations: Clone, move, and bulk create test cases
• Export/Import: Export test cases to Excel and import from Excel files
• Permission-Aware: Respects the same permissions as the web application
• Session-Based Auth: Works with your existing application session

Installation

Prerequisites

• Node.js 18.0.0 or higher
• Access to a Product-X Test Management System instance
• Valid user credentials for the system

Quick Install (Recommended)

Option 1: Using npx (No installation required)

Simply use npx in your MCP configuration - it will download and run the package automatically:

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@alternative-path/x-mcp"],
      "env": {
        "X_MCP_API_URL": "https://qa-path.com/api/auth",
        "X_MCP_PROJECT_ID": "your-project-id",
        "X_MCP_EMAIL": "[email protected]",
        "X_MCP_PASSWORD": "your-password"
      }
    }
  }
}

Option 2: Global Installation

npm install -g @alternative-path/x-mcp

Then use in your MCP configuration:

{
  "mcpServers": {
    "x-mcp": {
      "command": "x-mcp",
      "env": {
        "X_MCP_API_URL": "https://qa-path.com/api/auth",
        "X_MCP_PROJECT_ID": "your-project-id",
        "X_MCP_EMAIL": "[email protected]",
        "X_MCP_PASSWORD": "your-password"
      }
    }
  }
}

Option 3: Local Installation

npm install @alternative-path/x-mcp

Then use the full path:

{
  "mcpServers": {
    "x-mcp": {
      "command": "node",
      "args": ["./node_modules/@alternative-path/x-mcp/dist/index.js"],
      "env": {
        "X_MCP_API_URL": "https://your-domain.com/api/auth",
        "X_MCP_PROJECT_ID": "your-project-id",
        "X_MCP_EMAIL": "[email protected]",
        "X_MCP_PASSWORD": "your-password"
      }
    }
  }
}

Install from Source (Development)

git clone <repository-url>
cd x-mcp
npm install
npm run build

Configuration

X-MCP requires configuration via environment variables or a .env file.

Required Configuration

# API base URL — use your app URL + /api/auth (e.g. http://localhost:3000/api/auth)
X_MCP_API_URL=http://localhost:3000/api/auth

# Project ID (required for most operations)
X_MCP_PROJECT_ID=your-project-id-here

Authentication Options

You can authenticate using one of the following methods:

Option 1: Username/Password Login (Recommended)

Login directly with your email and password. The MCP server will create its own session:

[email protected]
X_MCP_PASSWORD=your-password

Note: The MCP server will automatically log in when it starts if these credentials are provided.

Option 2: Session Token

If you're already logged into the web application, you can extract your session token from the browser cookies:

X_MCP_SESSION_TOKEN=your-session-token-here

To get your session token:

1. Log into the web application
2. Open browser DevTools (F12)
3. Go to Application/Storage > Cookies
4. Copy the token cookie value

Option 3: API Key (if supported)

X_MCP_API_KEY=your-api-key-here

Complete Example .env file

# API Configuration
X_MCP_API_URL=http://localhost:3000/api/auth
X_MCP_PROJECT_ID=123e4567-e89b-12d3-a456-426614174000

# Authentication (choose one)
# Option 1: Username/Password (Recommended)
[email protected]
X_MCP_PASSWORD=your-password

# Option 2: Session Token
# X_MCP_SESSION_TOKEN=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

# Option 3: API Key
# X_MCP_API_KEY=your-api-key-here

Usage with Cursor

1. Open Cursor settings
2. Navigate to MCP settings
3. Add the following configuration:

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@alternative-path/x-mcp"],
      "env": {
        "X_MCP_API_URL": "http://localhost:3000/api/auth",
        "X_MCP_PROJECT_ID": "your-project-id",
        "X_MCP_SESSION_TOKEN": "your-session-token"
      }
    }
  }
}

Usage with VS Code

1. Install the MCP extension for VS Code
2. Configure the MCP server in your VS Code settings:

{
  "mcp.servers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@alternative-path/x-mcp"],
      "env": {
        "X_MCP_API_URL": "http://localhost:3000/api/auth",
        "X_MCP_PROJECT_ID": "your-project-id",
        "X_MCP_EMAIL": "[email protected]",
        "X_MCP_PASSWORD": "your-password"
      }
    }
  }
}

Tools and Prompts

For a complete list of all MCP tools and prompts, including parameters, sample prompts, and examples, see TOOLS_DOCUMENTATION.md.

Permissions

X-MCP respects the same permission system as the web application. Users can only perform actions they have permission for. If you receive a 403 Forbidden error, check your user permissions in the web application.

Troubleshooting

Authentication Errors

• 401 Unauthorized: Check your X_MCP_SESSION_TOKEN or X_MCP_API_KEY
• 403 Forbidden: You don't have permission for this action. Check your user role and permissions.

Connection Errors

• Network error: Verify that X_MCP_API_URL is correct and the server is accessible
• Timeout: The server might be slow. Try increasing the timeout in the API client.

Project ID Errors

• Make sure X_MCP_PROJECT_ID is set correctly
• You can also provide projectId as an argument to individual tool calls

Development

Building from Source

npm install
npm run build

Running in Development Mode

npm run dev

Testing

npm test

License

MIT

Support

For issues and questions, please contact the Product-X team or open an issue in the repository.