@testkase/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,206 @@
+# @testkase/mcp-server
+
+[![npm version](https://img.shields.io/npm/v/@testkase/mcp-server.svg)](https://www.npmjs.com/package/@testkase/mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Model Context Protocol (MCP) server for TestKase API. Enables AI agents like Claude Desktop and GitHub Copilot to interact with your TestKase testcase management system.
+
+## Features
+
+✨ **Get Testcases** - Retrieve testcases with advanced filtering and search
+📊 **Pagination** - Control page size and navigate through results
+🔍 **Advanced Filtering** - Filter by status, priority, dates, custom fields
+🔎 **Search** - Text search and AI-powered semantic search
+🔐 **Secure** - Uses Personal Access Token (PAT) authentication
+🤖 **AI-Ready** - Works with Claude Desktop, GitHub Copilot, and other MCP clients
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+npm install -g @testkase/mcp-server
+```
+
+### Local Installation
+
+```bash
+npm install @testkase/mcp-server
+```
+
+## Quick Start
+
+### 1. Get Your PAT Token
+
+1. Log in to [TestKase](https://apiqa.testkase.com)
+2. Navigate to **Settings → Personal Access Tokens**
+3. Click **"Generate New Token"**
+4. Copy the token (starts with `xyz_`)
+
+### 2. Configure Your AI Agent
+
+#### For Claude Desktop
+
+Edit your Claude config file:
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "testkase": {
+      "command": "npx",
+      "args": ["-y", "@testkase/mcp-server"],
+      "env": {
+        "TESTKASE_API_BASE_URL": "https://apiqa.testkase.com",
+        "TESTKASE_PAT_TOKEN": "xyz_your_pat_token_here"
+      }
+    }
+  }
+}
+```
+
+#### For GitHub Copilot (VS Code)
+
+Edit your Copilot config file:
+- **Windows**: `%APPDATA%\Code\User\globalStorage\github.copilot\mcp.json`
+- **macOS**: `~/Library/Application Support/Code/User/globalStorage/github.copilot/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "testkase": {
+      "command": "npx",
+      "args": ["-y", "@testkase/mcp-server"],
+      "env": {
+        "TESTKASE_API_BASE_URL": "https://apiqa.testkase.com",
+        "TESTKASE_PAT_TOKEN": "xyz_your_pat_token_here"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Your AI Agent
+
+- **Claude Desktop**: Close and reopen completely
+- **VS Code**: Restart VS Code
+
+### 4. Start Using!
+
+Ask your AI agent:
+- "Get testcases for project PRJ-1030 in organization 1171"
+- "Show high priority testcases from project ABC-123"
+- "Find testcases containing 'login' in project XYZ-456"
+
+## Available Tools
+
+### `get_testcases`
+
+Retrieve testcases from a project with optional filters and pagination.
+
+**Parameters:**
+- `projectId` (required): Project UUID
+- `organizationId` (required): Organization ID
+- `page`: Page number (default: 1)
+- `limit`: Items per page (default: 20)
+- `search`: Search term
+- `searchType`: `"normal"` or `"ai_search"`
+- `filters`: JSON string with filters
+- `sortBy`: Field to sort by
+- `sortOrder`: `"asc"` or `"desc"`
+- And more...
+
+## Configuration
+
+### Environment Variables
+
+- **`TESTKASE_API_BASE_URL`**: API base URL (default: `https://apiqa.testkase.com`)
+- **`TESTKASE_PAT_TOKEN`**: Your Personal Access Token (required)
+
+### Using with Different Environments
+
+**Production:**
+```json
+"env": {
+  "TESTKASE_API_BASE_URL": "https://api.testkase.com",
+  "TESTKASE_PAT_TOKEN": "xyz_your_token"
+}
+```
+
+**Local Development:**
+```json
+"env": {
+  "TESTKASE_API_BASE_URL": "http://localhost:8080",
+  "TESTKASE_PAT_TOKEN": "xyz_your_token"
+}
+```
+
+## Usage Examples
+
+### Basic Query
+```
+"Show me testcases for project PRJ-1030 organization 1171"
+```
+
+### Filtered Query
+```
+"Get high priority active testcases from project PRJ-1030 org 1171"
+```
+
+### Search Query
+```
+"Find testcases about 'authentication' in project PRJ-1030 org 1171"
+```
+
+### Date Range
+```
+"Show testcases updated this week in project PRJ-1030 org 1171"
+```
+
+## Troubleshooting
+
+### "Authentication required" error
+- Verify your PAT token is correct and starts with `xyz_`
+- Check that the token hasn't been revoked
+- Ensure it hasn't expired
+
+### Tool not showing up
+1. Restart your AI agent completely
+2. Check the config file path is correct
+3. Verify the JSON syntax is valid
+
+### API connection issues
+- Check that the API base URL is correct
+- Verify the TestKase API is accessible
+- Test with curl: `curl -H "Authorization: Bearer xyz_YOUR_TOKEN" https://apiqa.testkase.com/api/v1/projects/testcases/get-testcase/PROJECT_ID?organizationId=ORG_ID`
+
+## Documentation
+
+- [TestKase Documentation](https://docs.testkase.com)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+
+## Support
+
+- 📧 Email: support@testkase.com
+- 🌐 Website: [testkase.com](https://testkase.com)
+
+## Security
+
+- PAT tokens are sent securely via HTTPS
+- Tokens are validated by TestKase's backend
+- Each user has their own unique token
+- Tokens can be revoked at any time
+
+## License
+
+MIT © TestKase
+
+## Changelog
+
+### 1.0.0 (2026-01-30)
+- Initial release
+- Support for `get_testcases` tool
+- Claude Desktop and GitHub Copilot support
+- PAT token authentication
+- Advanced filtering and search capabilities

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import axios from "axios";
+// Get configuration from environment variables
+const config = {
+    apiBaseUrl: process.env.TESTKASE_API_BASE_URL || "https://apiqa.testkase.com",
+    patToken: process.env.TESTKASE_PAT_TOKEN,
+};
+// Tool definitions
+const GET_TESTCASES_TOOL = {
+    name: "get_testcases",
+    description: "Retrieve testcases from a project with optional filters, pagination, and search. " +
+        "Returns a list of testcases with their details including title, status, priority, owner, and more. " +
+        "Supports filtering by status, priority, dates, and other fields. " +
+        "Use this tool to query testcases for a specific project.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            projectId: {
+                type: "string",
+                description: "The unique identifier of the project (UUID format)",
+            },
+            organizationId: {
+                type: "number",
+                description: "The organization ID that owns the project",
+            },
+            page: {
+                type: "number",
+                description: "Page number for pagination (default: 1)",
+                default: 1,
+            },
+            limit: {
+                type: "number",
+                description: "Number of items per page (default: 20)",
+                default: 20,
+            },
+            selectAll: {
+                type: "boolean",
+                description: "If true, returns all testcases without pagination",
+                default: false,
+            },
+            columns: {
+                type: "string",
+                description: "Comma-separated list of columns to return. " +
+                    "Example: 'id,title,priority,status,automated,updated_by,created_at,updated_at'",
+            },
+            filters: {
+                type: "string",
+                description: "JSON string of filters to apply. " +
+                    'Example: {"status":["active","in_progress"],"priority":["high","critical"]}',
+            },
+            search: {
+                type: "string",
+                description: "Search term to filter testcases by title or summary",
+            },
+            searchType: {
+                type: "string",
+                enum: ["normal", "ai_search"],
+                description: "Type of search to perform: 'normal' for basic text search, 'ai_search' for semantic search",
+                default: "normal",
+            },
+            sortBy: {
+                type: "string",
+                description: "Field to sort by (default: 'updated_at')",
+                default: "updated_at",
+            },
+            sortOrder: {
+                type: "string",
+                enum: ["asc", "desc"],
+                description: "Sort order: 'asc' or 'desc' (default: 'desc')",
+                default: "desc",
+            },
+            create_start_date: {
+                type: "string",
+                description: "Filter by creation start date (ISO 8601 format: YYYY-MM-DD)",
+            },
+            create_end_date: {
+                type: "string",
+                description: "Filter by creation end date (ISO 8601 format: YYYY-MM-DD)",
+            },
+            updated_start_date: {
+                type: "string",
+                description: "Filter by update start date (ISO 8601 format: YYYY-MM-DD)",
+            },
+            updated_end_date: {
+                type: "string",
+                description: "Filter by update end date (ISO 8601 format: YYYY-MM-DD)",
+            },
+        },
+        required: ["projectId", "organizationId"],
+    },
+};
+// Create server instance
+const server = new Server({
+    name: "testkase-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [GET_TESTCASES_TOOL],
+    };
+});
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === "get_testcases") {
+            return await handleGetTestcases(args);
+        }
+        throw new Error(`Unknown tool: ${name}`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error.message}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        throw error;
+    }
+});
+// Handler for get_testcases tool
+async function handleGetTestcases(args) {
+    // Validate required parameters
+    if (!args.projectId) {
+        throw new Error("projectId is required");
+    }
+    if (!args.organizationId) {
+        throw new Error("organizationId is required");
+    }
+    // Check for authentication
+    if (!config.patToken) {
+        throw new Error("Authentication required. Please set TESTKASE_PAT_TOKEN environment variable. " +
+            "Generate a Personal Access Token (PAT) from your TestKase account settings.");
+    }
+    // Validate PAT token format
+    if (!config.patToken.startsWith("xyz_")) {
+        throw new Error("Invalid PAT token format. TestKase PAT tokens must start with 'xyz_' prefix. " +
+            "Please generate a valid PAT from your TestKase account settings.");
+    }
+    // Build query parameters
+    const queryParams = new URLSearchParams();
+    queryParams.append("organizationId", args.organizationId.toString());
+    if (args.page !== undefined)
+        queryParams.append("page", args.page.toString());
+    if (args.limit !== undefined)
+        queryParams.append("limit", args.limit.toString());
+    if (args.selectAll !== undefined)
+        queryParams.append("selectAll", args.selectAll.toString());
+    if (args.columns)
+        queryParams.append("columns", args.columns);
+    if (args.filters)
+        queryParams.append("filters", args.filters);
+    if (args.search)
+        queryParams.append("search", args.search);
+    if (args.searchType)
+        queryParams.append("searchType", args.searchType);
+    if (args.sortBy)
+        queryParams.append("sortBy", args.sortBy);
+    if (args.sortOrder)
+        queryParams.append("sortOrder", args.sortOrder);
+    if (args.create_start_date)
+        queryParams.append("create_start_date", args.create_start_date);
+    if (args.create_end_date)
+        queryParams.append("create_end_date", args.create_end_date);
+    if (args.updated_start_date)
+        queryParams.append("updated_start_date", args.updated_start_date);
+    if (args.updated_end_date)
+        queryParams.append("updated_end_date", args.updated_end_date);
+    // Construct API URL
+    const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase/${args.projectId}?${queryParams.toString()}`;
+    // Prepare headers with PAT token
+    // The PAT token is sent as Bearer token and will be validated by TestKase's JwtAuthGuard
+    // which checks for 'xyz_' prefix and validates against the PAT database
+    const headers = {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${config.patToken}`,
+    };
+    try {
+        // Make API request
+        const response = await axios.get(url, { headers });
+        // Format the response
+        const data = response.data;
+        let resultText = `# Testcases for Project ${args.projectId}\n\n`;
+        if (data.data && Array.isArray(data.data)) {
+            resultText += `**Total Results:** ${data.total || data.data.length}\n`;
+            if (data.page)
+                resultText += `**Page:** ${data.page}\n`;
+            if (data.limit)
+                resultText += `**Limit:** ${data.limit}\n`;
+            resultText += `\n## Testcases (${data.data.length} items)\n\n`;
+            data.data.forEach((testcase, index) => {
+                resultText += `### ${index + 1}. ${testcase.title || "Untitled"}\n`;
+                resultText += `- **ID:** ${testcase.id}\n`;
+                if (testcase.status)
+                    resultText += `- **Status:** ${testcase.status}\n`;
+                if (testcase.priority)
+                    resultText += `- **Priority:** ${testcase.priority}\n`;
+                if (testcase.automated !== undefined)
+                    resultText += `- **Automated:** ${testcase.automated}\n`;
+                if (testcase.summary)
+                    resultText += `- **Summary:** ${testcase.summary}\n`;
+                if (testcase.owner_id)
+                    resultText += `- **Owner ID:** ${testcase.owner_id}\n`;
+                if (testcase.folder_id)
+                    resultText += `- **Folder ID:** ${testcase.folder_id}\n`;
+                if (testcase.created_at)
+                    resultText += `- **Created:** ${testcase.created_at}\n`;
+                if (testcase.updated_at)
+                    resultText += `- **Updated:** ${testcase.updated_at}\n`;
+                if (testcase.labels && Array.isArray(testcase.labels) && testcase.labels.length > 0) {
+                    resultText += `- **Labels:** ${testcase.labels.join(", ")}\n`;
+                }
+                if (testcase.features && Array.isArray(testcase.features) && testcase.features.length > 0) {
+                    resultText += `- **Features:** ${testcase.features.join(", ")}\n`;
+                }
+                resultText += `\n`;
+            });
+        }
+        else {
+            resultText += "No testcases found or unexpected response format.\n\n";
+            resultText += `**Raw Response:**\n\`\`\`json\n${JSON.stringify(data, null, 2)}\n\`\`\`\n`;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: resultText,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            const axiosError = error;
+            let errorMessage = `API request failed: ${axiosError.message}`;
+            if (axiosError.response) {
+                errorMessage += `\nStatus: ${axiosError.response.status}`;
+                errorMessage += `\nResponse: ${JSON.stringify(axiosError.response.data)}`;
+            }
+            throw new Error(errorMessage);
+        }
+        throw error;
+    }
+}
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("TestKase MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error in main():", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/test-config.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-config.d.ts.map

package/build/test-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-config.d.ts","sourceRoot":"","sources":["../src/test-config.ts"],"names":[],"mappings":""}

package/build/test-config.js

@@ -0,0 +1,84 @@
+// Simple test script to verify MCP server configuration
+import axios from 'axios';
+import * as dotenv from 'dotenv';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Load environment variables
+dotenv.config({ path: path.join(__dirname, '..', '.env') });
+const API_BASE_URL = process.env.TESTKASE_API_BASE_URL || 'http://localhost:3000';
+const PAT_TOKEN = process.env.TESTKASE_PAT_TOKEN;
+console.log('🔍 Testing TestKase MCP Server Configuration\n');
+console.log('Configuration:');
+console.log(`  API Base URL: ${API_BASE_URL}`);
+console.log(`  PAT Token: ${PAT_TOKEN ? PAT_TOKEN.substring(0, 10) + '...' : 'NOT SET'}\n`);
+if (!PAT_TOKEN) {
+    console.error('❌ Error: TESTKASE_PAT_TOKEN not set in .env file');
+    process.exit(1);
+}
+if (!PAT_TOKEN.startsWith('xyz_')) {
+    console.error('❌ Error: PAT token must start with "xyz_" prefix');
+    process.exit(1);
+}
+console.log('✅ PAT token format is valid\n');
+// Test API connection
+console.log('🔗 Testing API connection...');
+async function testApiConnection() {
+    try {
+        // Try to hit a simple endpoint or the health check
+        const response = await axios.get(`${API_BASE_URL}/api/v1/projects/testcases/get-testcase/test-project?organizationId=1`, {
+            headers: {
+                'Authorization': `Bearer ${PAT_TOKEN}`,
+                'Content-Type': 'application/json',
+            },
+            validateStatus: () => true, // Accept any status code
+        });
+        console.log(`\n📊 API Response Status: ${response.status}`);
+        if (response.status === 200) {
+            console.log('✅ API connection successful!');
+            console.log('\n🎉 Your MCP server is configured correctly!');
+            console.log('\nNext steps:');
+            console.log('1. Start the MCP server: npm start');
+            console.log('2. Configure Claude Desktop with the config from claude_desktop_config.example.json');
+            console.log('3. Restart Claude Desktop');
+            console.log('4. Ask Claude to get testcases for your project');
+        }
+        else if (response.status === 401) {
+            console.log('⚠️  Authentication failed - PAT token may be invalid, revoked, or expired');
+            console.log('   Please check:');
+            console.log('   - Token is correct and starts with xyz_');
+            console.log('   - Token has not been revoked in TestKase');
+            console.log('   - Token has not expired');
+        }
+        else if (response.status === 404) {
+            console.log('⚠️  Test project not found (this is expected if you used a test project ID)');
+            console.log('✅ But authentication worked! Your PAT token is valid.');
+            console.log('\n🎉 Your MCP server is configured correctly!');
+        }
+        else {
+            console.log(`⚠️  Unexpected response: ${response.status}`);
+            console.log(`   Response: ${JSON.stringify(response.data, null, 2)}`);
+        }
+    }
+    catch (error) {
+        if (axios.isAxiosError(error)) {
+            if (error.code === 'ECONNREFUSED') {
+                console.log('❌ Cannot connect to API server');
+                console.log(`   Make sure TestKase backend is running at ${API_BASE_URL}`);
+            }
+            else {
+                console.log('❌ API request failed:', error.message);
+                if (error.response) {
+                    console.log(`   Status: ${error.response.status}`);
+                    console.log(`   Response: ${JSON.stringify(error.response.data, null, 2)}`);
+                }
+            }
+        }
+        else {
+            console.log('❌ Unexpected error:', error);
+        }
+    }
+}
+testApiConnection();
+//# sourceMappingURL=test-config.js.map

package/build/test-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-config.js","sourceRoot":"","sources":["../src/test-config.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,6BAA6B;AAC7B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAE5D,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,uBAAuB,CAAC;AAClF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;AAEjD,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;AAC9D,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAC9B,OAAO,CAAC,GAAG,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC;AAC/C,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;AAE5F,IAAI,CAAC,SAAS,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;IAClC,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;AAE7C,sBAAsB;AACtB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;AAE5C,KAAK,UAAU,iBAAiB;IAC9B,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,YAAY,uEAAuE,EAAE;YACvH,OAAO,EAAE;gBACP,eAAe,EAAE,UAAU,SAAS,EAAE;gBACtC,cAAc,EAAE,kBAAkB;aACnC;YACD,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,yBAAyB;SACtD,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,6BAA6B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAE5D,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;YAC5C,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;YAC7D,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,qFAAqF,CAAC,CAAC;YACnG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;QACjE,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,2EAA2E,CAAC,CAAC;YACzF,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;YAC1D,OAAO,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QAC5C,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;YAC3F,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;YACrE,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;QAC/D,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,4BAA4B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBAClC,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;gBAC9C,OAAO,CAAC,GAAG,CAAC,+CAA+C,YAAY,EAAE,CAAC,CAAC;YAC7E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;gBACpD,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBACnD,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;AACH,CAAC;AAED,iBAAiB,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@testkase/mcp-server",
+  "version": "1.0.0",
+  "description": "Model Context Protocol (MCP) server for TestKase API - Enables AI agents to interact with TestKase testcase management",
+  "type": "module",
+  "main": "./build/index.js",
+  "bin": {
+    "testkase-mcp": "./build/index.js"
+  },
+  "files": [
+    "build/",
+    "src/",
+    "README.md",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build",
+    "watch": "tsc --watch",
+    "start": "node build/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "testcase",
+    "test-management",
+    "api",
+    "testkase",
+    "ai-agent",
+    "claude",
+    "copilot",
+    "qa",
+    "testing"
+  ],
+  "author": "TestKase <support@testkase.com>",
+  "homepage": "https://github.com/SolvionIT/testkase-backend/tree/QA/mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SolvionIT/testkase-backend.git",
+    "directory": "mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/SolvionIT/testkase-backend/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^0.5.0",
+    "axios": "^1.6.0",
+    "dotenv": "^16.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,302 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+import axios, { AxiosError } from "axios";
+
+// Configuration interface
+interface Config {
+  apiBaseUrl: string;
+  patToken?: string;
+}
+
+// Get configuration from environment variables
+const config: Config = {
+  apiBaseUrl: process.env.TESTKASE_API_BASE_URL || "https://apiqa.testkase.com",
+  patToken: process.env.TESTKASE_PAT_TOKEN,
+};
+
+// Tool definitions
+const GET_TESTCASES_TOOL: Tool = {
+  name: "get_testcases",
+  description:
+    "Retrieve testcases from a project with optional filters, pagination, and search. " +
+    "Returns a list of testcases with their details including title, status, priority, owner, and more. " +
+    "Supports filtering by status, priority, dates, and other fields. " +
+    "Use this tool to query testcases for a specific project.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      projectId: {
+        type: "string",
+        description: "The unique identifier of the project (UUID format)",
+      },
+      organizationId: {
+        type: "number",
+        description: "The organization ID that owns the project",
+      },
+      page: {
+        type: "number",
+        description: "Page number for pagination (default: 1)",
+        default: 1,
+      },
+      limit: {
+        type: "number",
+        description: "Number of items per page (default: 20)",
+        default: 20,
+      },
+      selectAll: {
+        type: "boolean",
+        description: "If true, returns all testcases without pagination",
+        default: false,
+      },
+      columns: {
+        type: "string",
+        description:
+          "Comma-separated list of columns to return. " +
+          "Example: 'id,title,priority,status,automated,updated_by,created_at,updated_at'",
+      },
+      filters: {
+        type: "string",
+        description:
+          "JSON string of filters to apply. " +
+          'Example: {"status":["active","in_progress"],"priority":["high","critical"]}',
+      },
+      search: {
+        type: "string",
+        description: "Search term to filter testcases by title or summary",
+      },
+      searchType: {
+        type: "string",
+        enum: ["normal", "ai_search"],
+        description:
+          "Type of search to perform: 'normal' for basic text search, 'ai_search' for semantic search",
+        default: "normal",
+      },
+      sortBy: {
+        type: "string",
+        description: "Field to sort by (default: 'updated_at')",
+        default: "updated_at",
+      },
+      sortOrder: {
+        type: "string",
+        enum: ["asc", "desc"],
+        description: "Sort order: 'asc' or 'desc' (default: 'desc')",
+        default: "desc",
+      },
+      create_start_date: {
+        type: "string",
+        description: "Filter by creation start date (ISO 8601 format: YYYY-MM-DD)",
+      },
+      create_end_date: {
+        type: "string",
+        description: "Filter by creation end date (ISO 8601 format: YYYY-MM-DD)",
+      },
+      updated_start_date: {
+        type: "string",
+        description: "Filter by update start date (ISO 8601 format: YYYY-MM-DD)",
+      },
+      updated_end_date: {
+        type: "string",
+        description: "Filter by update end date (ISO 8601 format: YYYY-MM-DD)",
+      },
+    },
+    required: ["projectId", "organizationId"],
+  },
+};
+
+// Create server instance
+const server = new Server(
+  {
+    name: "testkase-mcp-server",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// List available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [GET_TESTCASES_TOOL],
+  };
+});
+
+// Handle tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    if (name === "get_testcases") {
+      return await handleGetTestcases(args as any);
+    }
+
+    throw new Error(`Unknown tool: ${name}`);
+  } catch (error) {
+    if (error instanceof Error) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Error: ${error.message}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+    throw error;
+  }
+});
+
+// Handler for get_testcases tool
+async function handleGetTestcases(args: {
+  projectId: string;
+  organizationId: number;
+  page?: number;
+  limit?: number;
+  selectAll?: boolean;
+  columns?: string;
+  filters?: string;
+  search?: string;
+  searchType?: string;
+  sortBy?: string;
+  sortOrder?: string;
+  create_start_date?: string;
+  create_end_date?: string;
+  updated_start_date?: string;
+  updated_end_date?: string;
+}) {
+  // Validate required parameters
+  if (!args.projectId) {
+    throw new Error("projectId is required");
+  }
+  if (!args.organizationId) {
+    throw new Error("organizationId is required");
+  }
+
+  // Check for authentication
+  if (!config.patToken) {
+    throw new Error(
+      "Authentication required. Please set TESTKASE_PAT_TOKEN environment variable. " +
+      "Generate a Personal Access Token (PAT) from your TestKase account settings."
+    );
+  }
+
+  // Validate PAT token format
+  if (!config.patToken.startsWith("xyz_")) {
+    throw new Error(
+      "Invalid PAT token format. TestKase PAT tokens must start with 'xyz_' prefix. " +
+      "Please generate a valid PAT from your TestKase account settings."
+    );
+  }
+
+  // Build query parameters
+  const queryParams = new URLSearchParams();
+  queryParams.append("organizationId", args.organizationId.toString());
+
+  if (args.page !== undefined) queryParams.append("page", args.page.toString());
+  if (args.limit !== undefined) queryParams.append("limit", args.limit.toString());
+  if (args.selectAll !== undefined) queryParams.append("selectAll", args.selectAll.toString());
+  if (args.columns) queryParams.append("columns", args.columns);
+  if (args.filters) queryParams.append("filters", args.filters);
+  if (args.search) queryParams.append("search", args.search);
+  if (args.searchType) queryParams.append("searchType", args.searchType);
+  if (args.sortBy) queryParams.append("sortBy", args.sortBy);
+  if (args.sortOrder) queryParams.append("sortOrder", args.sortOrder);
+  if (args.create_start_date) queryParams.append("create_start_date", args.create_start_date);
+  if (args.create_end_date) queryParams.append("create_end_date", args.create_end_date);
+  if (args.updated_start_date) queryParams.append("updated_start_date", args.updated_start_date);
+  if (args.updated_end_date) queryParams.append("updated_end_date", args.updated_end_date);
+
+  // Construct API URL
+  const url = `${config.apiBaseUrl}/api/v1/projects/testcases/get-testcase/${args.projectId}?${queryParams.toString()}`;
+
+  // Prepare headers with PAT token
+  // The PAT token is sent as Bearer token and will be validated by TestKase's JwtAuthGuard
+  // which checks for 'xyz_' prefix and validates against the PAT database
+  const headers: Record<string, string> = {
+    "Content-Type": "application/json",
+    "Authorization": `Bearer ${config.patToken}`,
+  };
+
+  try {
+    // Make API request
+    const response = await axios.get(url, { headers });
+
+    // Format the response
+    const data = response.data;
+    let resultText = `# Testcases for Project ${args.projectId}\n\n`;
+
+    if (data.data && Array.isArray(data.data)) {
+      resultText += `**Total Results:** ${data.total || data.data.length}\n`;
+      if (data.page) resultText += `**Page:** ${data.page}\n`;
+      if (data.limit) resultText += `**Limit:** ${data.limit}\n`;
+      resultText += `\n## Testcases (${data.data.length} items)\n\n`;
+
+      data.data.forEach((testcase: any, index: number) => {
+        resultText += `### ${index + 1}. ${testcase.title || "Untitled"}\n`;
+        resultText += `- **ID:** ${testcase.id}\n`;
+        if (testcase.status) resultText += `- **Status:** ${testcase.status}\n`;
+        if (testcase.priority) resultText += `- **Priority:** ${testcase.priority}\n`;
+        if (testcase.automated !== undefined) resultText += `- **Automated:** ${testcase.automated}\n`;
+        if (testcase.summary) resultText += `- **Summary:** ${testcase.summary}\n`;
+        if (testcase.owner_id) resultText += `- **Owner ID:** ${testcase.owner_id}\n`;
+        if (testcase.folder_id) resultText += `- **Folder ID:** ${testcase.folder_id}\n`;
+        if (testcase.created_at) resultText += `- **Created:** ${testcase.created_at}\n`;
+        if (testcase.updated_at) resultText += `- **Updated:** ${testcase.updated_at}\n`;
+        if (testcase.labels && Array.isArray(testcase.labels) && testcase.labels.length > 0) {
+          resultText += `- **Labels:** ${testcase.labels.join(", ")}\n`;
+        }
+        if (testcase.features && Array.isArray(testcase.features) && testcase.features.length > 0) {
+          resultText += `- **Features:** ${testcase.features.join(", ")}\n`;
+        }
+        resultText += `\n`;
+      });
+    } else {
+      resultText += "No testcases found or unexpected response format.\n\n";
+      resultText += `**Raw Response:**\n\`\`\`json\n${JSON.stringify(data, null, 2)}\n\`\`\`\n`;
+    }
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: resultText,
+        },
+      ],
+    };
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      const axiosError = error as AxiosError;
+      let errorMessage = `API request failed: ${axiosError.message}`;
+
+      if (axiosError.response) {
+        errorMessage += `\nStatus: ${axiosError.response.status}`;
+        errorMessage += `\nResponse: ${JSON.stringify(axiosError.response.data)}`;
+      }
+
+      throw new Error(errorMessage);
+    }
+    throw error;
+  }
+}
+
+// Start the server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("TestKase MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error in main():", error);
+  process.exit(1);
+});

package/src/test-config.ts

@@ -0,0 +1,89 @@
+// Simple test script to verify MCP server configuration
+import axios from 'axios';
+import * as dotenv from 'dotenv';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// Load environment variables
+dotenv.config({ path: path.join(__dirname, '..', '.env') });
+
+const API_BASE_URL = process.env.TESTKASE_API_BASE_URL || 'http://localhost:3000';
+const PAT_TOKEN = process.env.TESTKASE_PAT_TOKEN;
+
+console.log('🔍 Testing TestKase MCP Server Configuration\n');
+console.log('Configuration:');
+console.log(`  API Base URL: ${API_BASE_URL}`);
+console.log(`  PAT Token: ${PAT_TOKEN ? PAT_TOKEN.substring(0, 10) + '...' : 'NOT SET'}\n`);
+
+if (!PAT_TOKEN) {
+  console.error('❌ Error: TESTKASE_PAT_TOKEN not set in .env file');
+  process.exit(1);
+}
+
+if (!PAT_TOKEN.startsWith('xyz_')) {
+  console.error('❌ Error: PAT token must start with "xyz_" prefix');
+  process.exit(1);
+}
+
+console.log('✅ PAT token format is valid\n');
+
+// Test API connection
+console.log('🔗 Testing API connection...');
+
+async function testApiConnection() {
+  try {
+    // Try to hit a simple endpoint or the health check
+    const response = await axios.get(`${API_BASE_URL}/api/v1/projects/testcases/get-testcase/test-project?organizationId=1`, {
+      headers: {
+        'Authorization': `Bearer ${PAT_TOKEN}`,
+        'Content-Type': 'application/json',
+      },
+      validateStatus: () => true, // Accept any status code
+    });
+
+    console.log(`\n📊 API Response Status: ${response.status}`);
+    
+    if (response.status === 200) {
+      console.log('✅ API connection successful!');
+      console.log('\n🎉 Your MCP server is configured correctly!');
+      console.log('\nNext steps:');
+      console.log('1. Start the MCP server: npm start');
+      console.log('2. Configure Claude Desktop with the config from claude_desktop_config.example.json');
+      console.log('3. Restart Claude Desktop');
+      console.log('4. Ask Claude to get testcases for your project');
+    } else if (response.status === 401) {
+      console.log('⚠️  Authentication failed - PAT token may be invalid, revoked, or expired');
+      console.log('   Please check:');
+      console.log('   - Token is correct and starts with xyz_');
+      console.log('   - Token has not been revoked in TestKase');
+      console.log('   - Token has not expired');
+    } else if (response.status === 404) {
+      console.log('⚠️  Test project not found (this is expected if you used a test project ID)');
+      console.log('✅ But authentication worked! Your PAT token is valid.');
+      console.log('\n🎉 Your MCP server is configured correctly!');
+    } else {
+      console.log(`⚠️  Unexpected response: ${response.status}`);
+      console.log(`   Response: ${JSON.stringify(response.data, null, 2)}`);
+    }
+  } catch (error) {
+    if (axios.isAxiosError(error)) {
+      if (error.code === 'ECONNREFUSED') {
+        console.log('❌ Cannot connect to API server');
+        console.log(`   Make sure TestKase backend is running at ${API_BASE_URL}`);
+      } else {
+        console.log('❌ API request failed:', error.message);
+        if (error.response) {
+          console.log(`   Status: ${error.response.status}`);
+          console.log(`   Response: ${JSON.stringify(error.response.data, null, 2)}`);
+        }
+      }
+    } else {
+      console.log('❌ Unexpected error:', error);
+    }
+  }
+}
+
+testApiConnection();

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "outDir": "./build",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "build"]
+}