cntx-ui 2.0.9 → 2.0.11
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 +67 -8
- package/bin/cntx-ui.js +11 -2
- package/lib/mcp-server.js +4 -0
- package/package.json +16 -6
- package/server.js +209 -84
- package/web/dist/assets/index-AIbnyG7t.js +531 -0
- package/web/dist/index.html +1 -1
- package/web/dist/assets/index-DL3ZyEog.js +0 -531
package/README.md
CHANGED
|
@@ -54,8 +54,14 @@ cntx-ui status
|
|
|
54
54
|
# Start web server on custom port
|
|
55
55
|
cntx-ui watch [port]
|
|
56
56
|
|
|
57
|
+
# Start web server with MCP status tracking
|
|
58
|
+
cntx-ui watch --with-mcp
|
|
59
|
+
|
|
57
60
|
# Start MCP server for AI integration
|
|
58
61
|
cntx-ui mcp
|
|
62
|
+
|
|
63
|
+
# Add project to Claude Desktop MCP configuration
|
|
64
|
+
cntx-ui setup-mcp
|
|
59
65
|
```
|
|
60
66
|
|
|
61
67
|
### MCP Integration
|
|
@@ -165,16 +171,68 @@ cntx-ui/
|
|
|
165
171
|
|
|
166
172
|
## MCP Server Setup
|
|
167
173
|
|
|
174
|
+
### Quick Setup with setup-mcp Command
|
|
175
|
+
|
|
176
|
+
The easiest way to configure cntx-ui for Claude Desktop:
|
|
177
|
+
|
|
178
|
+
```bash
|
|
179
|
+
# Navigate to your project directory
|
|
180
|
+
cd /path/to/your/project
|
|
181
|
+
|
|
182
|
+
# Initialize cntx-ui if not already done
|
|
183
|
+
cntx-ui init
|
|
184
|
+
|
|
185
|
+
# Add this project to Claude Desktop MCP configuration
|
|
186
|
+
cntx-ui setup-mcp
|
|
187
|
+
```
|
|
188
|
+
|
|
189
|
+
This automatically adds your project to Claude Desktop's configuration file and allows you to work with multiple projects simultaneously.
|
|
190
|
+
|
|
168
191
|
### Claude Desktop Integration
|
|
169
192
|
|
|
170
|
-
|
|
193
|
+
#### Multi-Project Setup (Recommended)
|
|
194
|
+
|
|
195
|
+
You can use cntx-ui across multiple projects by running `setup-mcp` in each project directory:
|
|
196
|
+
|
|
197
|
+
```bash
|
|
198
|
+
# Project 1
|
|
199
|
+
cd /Users/you/project1
|
|
200
|
+
cntx-ui setup-mcp
|
|
201
|
+
|
|
202
|
+
# Project 2
|
|
203
|
+
cd /Users/you/project2
|
|
204
|
+
cntx-ui setup-mcp
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
This creates entries in your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
|
|
208
|
+
|
|
209
|
+
```json
|
|
210
|
+
{
|
|
211
|
+
"mcpServers": {
|
|
212
|
+
"cntx-ui-project1": {
|
|
213
|
+
"command": "sh",
|
|
214
|
+
"args": ["-c", "cd /Users/you/project1 && node /path/to/cntx-ui/bin/cntx-ui.js mcp"],
|
|
215
|
+
"cwd": "/Users/you/project1"
|
|
216
|
+
},
|
|
217
|
+
"cntx-ui-project2": {
|
|
218
|
+
"command": "sh",
|
|
219
|
+
"args": ["-c", "cd /Users/you/project2 && node /path/to/cntx-ui/bin/cntx-ui.js mcp"],
|
|
220
|
+
"cwd": "/Users/you/project2"
|
|
221
|
+
}
|
|
222
|
+
}
|
|
223
|
+
}
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
#### Manual Configuration
|
|
227
|
+
|
|
228
|
+
For manual setup, add to your Claude Desktop configuration:
|
|
171
229
|
|
|
172
230
|
```json
|
|
173
231
|
{
|
|
174
232
|
"mcpServers": {
|
|
175
|
-
"cntx-ui": {
|
|
176
|
-
"command": "
|
|
177
|
-
"args": ["mcp"],
|
|
233
|
+
"cntx-ui-projectname": {
|
|
234
|
+
"command": "sh",
|
|
235
|
+
"args": ["-c", "cd /path/to/your/project && cntx-ui mcp"],
|
|
178
236
|
"cwd": "/path/to/your/project"
|
|
179
237
|
}
|
|
180
238
|
}
|
|
@@ -190,10 +248,11 @@ For other MCP-compatible clients, use:
|
|
|
190
248
|
|
|
191
249
|
### MCP Workflow
|
|
192
250
|
|
|
193
|
-
1. **
|
|
194
|
-
2. **
|
|
195
|
-
3. **
|
|
196
|
-
4. **
|
|
251
|
+
1. **Setup**: Run `cntx-ui setup-mcp` in each project you want to use with Claude Desktop
|
|
252
|
+
2. **Visual Configuration**: Use `cntx-ui watch` to configure bundles via web UI
|
|
253
|
+
3. **AI Integration**: AI clients connect via MCP to access bundles across all configured projects
|
|
254
|
+
4. **Real-time Updates**: Changes in web UI immediately available to AI tools
|
|
255
|
+
5. **Multi-Project**: Claude Desktop can access bundles from all configured projects simultaneously
|
|
197
256
|
|
|
198
257
|
## Testing
|
|
199
258
|
|
package/bin/cntx-ui.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
|
|
3
|
-
import { startServer, startMCPServer, generateBundle, initConfig, getStatus } from '../server.js';
|
|
3
|
+
import { startServer, startMCPServer, generateBundle, initConfig, getStatus, setupMCP } from '../server.js';
|
|
4
4
|
|
|
5
5
|
const args = process.argv.slice(2);
|
|
6
6
|
const command = args[0] || 'watch';
|
|
@@ -14,7 +14,8 @@ process.on('SIGINT', () => {
|
|
|
14
14
|
switch (command) {
|
|
15
15
|
case 'watch':
|
|
16
16
|
const port = parseInt(args[1]) || 3333;
|
|
17
|
-
|
|
17
|
+
const withMcp = args.includes('--with-mcp');
|
|
18
|
+
startServer({ port, withMcp });
|
|
18
19
|
break;
|
|
19
20
|
|
|
20
21
|
case 'mcp':
|
|
@@ -40,19 +41,27 @@ switch (command) {
|
|
|
40
41
|
getStatus();
|
|
41
42
|
break;
|
|
42
43
|
|
|
44
|
+
case 'setup-mcp':
|
|
45
|
+
setupMCP();
|
|
46
|
+
break;
|
|
47
|
+
|
|
43
48
|
default:
|
|
44
49
|
console.log(`cntx-ui v2.0.8
|
|
45
50
|
|
|
46
51
|
Usage:
|
|
47
52
|
cntx-ui init Initialize configuration
|
|
48
53
|
cntx-ui watch [port] Start web server (default port: 3333)
|
|
54
|
+
cntx-ui watch --with-mcp Start web server with MCP status tracking
|
|
49
55
|
cntx-ui mcp Start MCP server (stdio transport)
|
|
56
|
+
cntx-ui setup-mcp Add this project to Claude Desktop MCP config
|
|
50
57
|
cntx-ui bundle [name] Generate specific bundle (default: master)
|
|
51
58
|
cntx-ui status Show current status
|
|
52
59
|
|
|
53
60
|
Examples:
|
|
54
61
|
cntx-ui init
|
|
55
62
|
cntx-ui watch 8080
|
|
63
|
+
cntx-ui watch --with-mcp
|
|
64
|
+
cntx-ui setup-mcp
|
|
56
65
|
cntx-ui mcp
|
|
57
66
|
cntx-ui bundle api
|
|
58
67
|
|
package/lib/mcp-server.js
CHANGED
|
@@ -37,6 +37,7 @@ export class MCPServer {
|
|
|
37
37
|
return this.handleInitialize(params, id);
|
|
38
38
|
|
|
39
39
|
case 'initialized':
|
|
40
|
+
case 'notifications/initialized':
|
|
40
41
|
return null; // No response needed for notification
|
|
41
42
|
|
|
42
43
|
case 'resources/list':
|
|
@@ -51,6 +52,9 @@ export class MCPServer {
|
|
|
51
52
|
case 'tools/call':
|
|
52
53
|
return this.handleCallTool(params, id);
|
|
53
54
|
|
|
55
|
+
case 'prompts/list':
|
|
56
|
+
return this.createErrorResponse(id, -32601, 'Method not found');
|
|
57
|
+
|
|
54
58
|
default:
|
|
55
59
|
return this.createErrorResponse(id, -32601, 'Method not found');
|
|
56
60
|
}
|
package/package.json
CHANGED
|
@@ -1,14 +1,24 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cntx-ui",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "2.0.
|
|
5
|
-
"description": "
|
|
4
|
+
"version": "2.0.11",
|
|
5
|
+
"description": "File context management tool with web UI and MCP server for AI development workflows - bundle project files for LLM consumption",
|
|
6
6
|
"keywords": [
|
|
7
|
-
"ai",
|
|
8
|
-
"
|
|
9
|
-
"file-
|
|
7
|
+
"ai-development",
|
|
8
|
+
"mcp-server",
|
|
9
|
+
"file-bundling",
|
|
10
|
+
"context-management",
|
|
11
|
+
"llm-tools",
|
|
12
|
+
"claude-desktop",
|
|
13
|
+
"model-context-protocol",
|
|
14
|
+
"file-aggregation",
|
|
15
|
+
"project-context",
|
|
16
|
+
"ai-workflow",
|
|
17
|
+
"codebase-bundling",
|
|
10
18
|
"development-tools",
|
|
11
|
-
"
|
|
19
|
+
"websocket",
|
|
20
|
+
"react",
|
|
21
|
+
"cli-tool"
|
|
12
22
|
],
|
|
13
23
|
"repository": {
|
|
14
24
|
"type": "git",
|