@alternative-path/x-mcp 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -14
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
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.
|
|
4
4
|
|
|
5
|
+
**Quick links:** [Install from npm](QUICK_INSTALL.md) · [Run from source](QUICK_START.md) · [All tools](TOOLS_DOCUMENTATION.md)
|
|
6
|
+
|
|
5
7
|
## Features
|
|
6
8
|
|
|
7
9
|
- **x-test-planner agent**: Standard, repeatable test planning via an MCP prompt that uses embedded context (no manual context file required)
|
|
@@ -31,9 +33,9 @@ Simply use `npx` in your MCP configuration - it will download and run the packag
|
|
|
31
33
|
"mcpServers": {
|
|
32
34
|
"x-mcp": {
|
|
33
35
|
"command": "npx",
|
|
34
|
-
"args": ["-y", "@
|
|
36
|
+
"args": ["-y", "@alternative-path/x-mcp"],
|
|
35
37
|
"env": {
|
|
36
|
-
"X_MCP_API_URL": "https://qa-path.com/api",
|
|
38
|
+
"X_MCP_API_URL": "https://qa-path.com/api/auth",
|
|
37
39
|
"X_MCP_PROJECT_ID": "your-project-id",
|
|
38
40
|
"X_MCP_EMAIL": "your-email@example.com",
|
|
39
41
|
"X_MCP_PASSWORD": "your-password"
|
|
@@ -46,7 +48,7 @@ Simply use `npx` in your MCP configuration - it will download and run the packag
|
|
|
46
48
|
**Option 2: Global Installation**
|
|
47
49
|
|
|
48
50
|
```bash
|
|
49
|
-
npm install -g @
|
|
51
|
+
npm install -g @alternative-path/x-mcp
|
|
50
52
|
```
|
|
51
53
|
|
|
52
54
|
Then use in your MCP configuration:
|
|
@@ -56,7 +58,7 @@ Then use in your MCP configuration:
|
|
|
56
58
|
"x-mcp": {
|
|
57
59
|
"command": "x-mcp",
|
|
58
60
|
"env": {
|
|
59
|
-
"X_MCP_API_URL": "https://qa-path.com/api",
|
|
61
|
+
"X_MCP_API_URL": "https://qa-path.com/api/auth",
|
|
60
62
|
"X_MCP_PROJECT_ID": "your-project-id",
|
|
61
63
|
"X_MCP_EMAIL": "your-email@example.com",
|
|
62
64
|
"X_MCP_PASSWORD": "your-password"
|
|
@@ -69,7 +71,7 @@ Then use in your MCP configuration:
|
|
|
69
71
|
**Option 3: Local Installation**
|
|
70
72
|
|
|
71
73
|
```bash
|
|
72
|
-
npm install @
|
|
74
|
+
npm install @alternative-path/x-mcp
|
|
73
75
|
```
|
|
74
76
|
|
|
75
77
|
Then use the full path:
|
|
@@ -78,9 +80,9 @@ Then use the full path:
|
|
|
78
80
|
"mcpServers": {
|
|
79
81
|
"x-mcp": {
|
|
80
82
|
"command": "node",
|
|
81
|
-
"args": ["./node_modules/@
|
|
83
|
+
"args": ["./node_modules/@alternative-path/x-mcp/dist/index.js"],
|
|
82
84
|
"env": {
|
|
83
|
-
"X_MCP_API_URL": "https://
|
|
85
|
+
"X_MCP_API_URL": "https://your-domain.com/api/auth",
|
|
84
86
|
"X_MCP_PROJECT_ID": "your-project-id",
|
|
85
87
|
"X_MCP_EMAIL": "your-email@example.com",
|
|
86
88
|
"X_MCP_PASSWORD": "your-password"
|
|
@@ -106,8 +108,8 @@ X-MCP requires configuration via environment variables or a `.env` file.
|
|
|
106
108
|
### Required Configuration
|
|
107
109
|
|
|
108
110
|
```bash
|
|
109
|
-
# API
|
|
110
|
-
X_MCP_API_URL=http://localhost:3000/api
|
|
111
|
+
# API base URL — use your app URL + /api/auth (e.g. http://localhost:3000/api/auth)
|
|
112
|
+
X_MCP_API_URL=http://localhost:3000/api/auth
|
|
111
113
|
|
|
112
114
|
# Project ID (required for most operations)
|
|
113
115
|
X_MCP_PROJECT_ID=your-project-id-here
|
|
@@ -152,7 +154,7 @@ X_MCP_API_KEY=your-api-key-here
|
|
|
152
154
|
|
|
153
155
|
```bash
|
|
154
156
|
# API Configuration
|
|
155
|
-
X_MCP_API_URL=http://localhost:3000/api
|
|
157
|
+
X_MCP_API_URL=http://localhost:3000/api/auth
|
|
156
158
|
X_MCP_PROJECT_ID=123e4567-e89b-12d3-a456-426614174000
|
|
157
159
|
|
|
158
160
|
# Authentication (choose one)
|
|
@@ -178,9 +180,9 @@ X_MCP_PASSWORD=your-password
|
|
|
178
180
|
"mcpServers": {
|
|
179
181
|
"x-mcp": {
|
|
180
182
|
"command": "npx",
|
|
181
|
-
"args": ["-y", "@
|
|
183
|
+
"args": ["-y", "@alternative-path/x-mcp"],
|
|
182
184
|
"env": {
|
|
183
|
-
"X_MCP_API_URL": "http://localhost:3000/api",
|
|
185
|
+
"X_MCP_API_URL": "http://localhost:3000/api/auth",
|
|
184
186
|
"X_MCP_PROJECT_ID": "your-project-id",
|
|
185
187
|
"X_MCP_SESSION_TOKEN": "your-session-token"
|
|
186
188
|
}
|
|
@@ -199,9 +201,9 @@ X_MCP_PASSWORD=your-password
|
|
|
199
201
|
"mcp.servers": {
|
|
200
202
|
"x-mcp": {
|
|
201
203
|
"command": "npx",
|
|
202
|
-
"args": ["-y", "@
|
|
204
|
+
"args": ["-y", "@alternative-path/x-mcp"],
|
|
203
205
|
"env": {
|
|
204
|
-
"X_MCP_API_URL": "http://localhost:3000/api",
|
|
206
|
+
"X_MCP_API_URL": "http://localhost:3000/api/auth",
|
|
205
207
|
"X_MCP_PROJECT_ID": "your-project-id",
|
|
206
208
|
"X_MCP_EMAIL": "your-email@example.com",
|
|
207
209
|
"X_MCP_PASSWORD": "your-password"
|
package/dist/index.js
CHANGED
|
@@ -33,7 +33,7 @@ class XMCPServer {
|
|
|
33
33
|
},
|
|
34
34
|
});
|
|
35
35
|
// Initialize API client
|
|
36
|
-
const apiBaseUrl = process.env.X_MCP_API_URL || "http://localhost:3000/api";
|
|
36
|
+
const apiBaseUrl = process.env.X_MCP_API_URL || "http://localhost:3000/api/auth";
|
|
37
37
|
const apiKey = process.env.X_MCP_API_KEY;
|
|
38
38
|
const sessionToken = process.env.X_MCP_SESSION_TOKEN;
|
|
39
39
|
const projectId = process.env.X_MCP_PROJECT_ID;
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EACL,8BAA8B,EAC9B,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,MAAM,UAAU;IACN,MAAM,CAAS;IACf,SAAS,CAAY;IACrB,WAAW,CAAc;IACzB,aAAa,CAAgB;IAC7B,iBAAiB,CAAoB;IACrC,YAAY,CAAe;IAC3B,SAAS,CAAY;IACrB,eAAe,CAAkB;IACjC,oBAAoB,CAAuB;IAEnD;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CACtB;YACE,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,OAAO;SACjB,EACD;YACE,YAAY,EAAE;gBACZ,KAAK,EAAE,EAAE;gBACT,SAAS,EAAE,EAAE;gBACb,OAAO,EAAE,EAAE;aACZ;SACF,CACF,CAAC;QAEF,wBAAwB;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@alternative-path/x-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "MCP server for Product-X Test Management System - Manage test cases, modules, components, and subcomponents via Cursor and VS Code",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"type": "module",
|