zephex 2.0.7 → 2.0.14
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 +11 -40
- package/dist/cli.js +15 -6
- package/dist/index.js +51392 -123015
- package/dist/tools/architecture/index.js +922 -272
- package/dist/tools/audit_headers/index.js +705 -381
- package/dist/tools/context/index.js +1918 -372
- package/dist/tools/reader/readCode.js +577 -443
- package/dist/tools/scope_task/index.js +24336 -19340
- package/dist/tools/search/findCode.js +23308 -19243
- package/dist/tools/server.js +34249 -107163
- package/dist/tools/thinking/index.js +904 -264
- package/package.json +2 -2
- package/dist/tools/inspect_url/index.js +0 -166175
package/README.md
CHANGED
|
@@ -40,26 +40,11 @@ Add to `claude_desktop_config.json`:
|
|
|
40
40
|
{
|
|
41
41
|
"mcpServers": {
|
|
42
42
|
"zephex": {
|
|
43
|
+
"type": "stdio",
|
|
43
44
|
"command": "npx",
|
|
44
|
-
"args": ["zephex"]
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
}
|
|
48
|
-
```
|
|
49
|
-
|
|
50
|
-
For local development without Supabase or Stripe credentials, start with `MCP_LOCAL_ONLY=true` so the proxy serves built-in tools only.
|
|
51
|
-
|
|
52
|
-
### Remote HTTP Mode
|
|
53
|
-
|
|
54
|
-
For remote access with API key authentication:
|
|
55
|
-
|
|
56
|
-
```json
|
|
57
|
-
{
|
|
58
|
-
"mcpServers": {
|
|
59
|
-
"zephex": {
|
|
60
|
-
"url": "https://zephex.dev/mcp",
|
|
61
|
-
"headers": {
|
|
62
|
-
"Authorization": "Bearer mcp_sk_your_api_key"
|
|
45
|
+
"args": ["-y", "zephex"],
|
|
46
|
+
"env": {
|
|
47
|
+
"ZEPHEX_API_KEY": "mcp_sk_your_api_key"
|
|
63
48
|
}
|
|
64
49
|
}
|
|
65
50
|
}
|
|
@@ -68,36 +53,22 @@ For remote access with API key authentication:
|
|
|
68
53
|
|
|
69
54
|
Get your API key from the [dashboard](https://zephex.dev/dashboard/api-keys).
|
|
70
55
|
|
|
71
|
-
### Cursor
|
|
72
|
-
|
|
73
|
-
Cursor has a known issue with spaces in header values, and also limits MCP servers to ~40 tools. Use the `mcp-remote` bridge with the no-space header workaround:
|
|
56
|
+
### Cursor
|
|
74
57
|
|
|
75
58
|
```json
|
|
76
59
|
{
|
|
77
60
|
"mcpServers": {
|
|
78
61
|
"zephex": {
|
|
79
62
|
"command": "npx",
|
|
80
|
-
"args": [
|
|
81
|
-
"-y",
|
|
82
|
-
"mcp-remote@0.1.38",
|
|
83
|
-
"https://zephex.dev/mcp",
|
|
84
|
-
"--header",
|
|
85
|
-
"Authorization:${AUTH_HEADER}",
|
|
86
|
-
"--header",
|
|
87
|
-
"X-API-Source:cursor",
|
|
88
|
-
"--transport",
|
|
89
|
-
"http-only"
|
|
90
|
-
],
|
|
63
|
+
"args": ["-y", "zephex"],
|
|
91
64
|
"env": {
|
|
92
|
-
"
|
|
65
|
+
"ZEPHEX_API_KEY": "mcp_sk_your_api_key"
|
|
93
66
|
}
|
|
94
67
|
}
|
|
95
68
|
}
|
|
96
69
|
}
|
|
97
70
|
```
|
|
98
71
|
|
|
99
|
-
> Security note: keep `mcp-remote` at `>=0.1.16` (this guide pins `0.1.38`) to avoid CVE-2025-6514.
|
|
100
|
-
|
|
101
72
|
## Features
|
|
102
73
|
|
|
103
74
|
- **Multi-backend routing** - Combine multiple MCP servers with namespaced tools
|
|
@@ -438,13 +409,13 @@ Note: `--cap-add=SYS_ADMIN` is required locally for Chrome's sandbox. Railway ha
|
|
|
438
409
|
### Testing the Deployed Server
|
|
439
410
|
|
|
440
411
|
```bash
|
|
441
|
-
# Test 1: Verify tools/list returns
|
|
412
|
+
# Test 1: Verify tools/list returns Zephex_dev_info
|
|
442
413
|
curl -s -X POST https://YOUR-URL.railway.app/mcp \
|
|
443
414
|
-H "Content-Type: application/json" \
|
|
444
415
|
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
|
|
445
|
-
| jq '.result.tools[] | select(.name=="
|
|
416
|
+
| jq '.result.tools[] | select(.name=="Zephex_dev_info") | {name, title}'
|
|
446
417
|
|
|
447
|
-
# Test 2: Run
|
|
418
|
+
# Test 2: Run Zephex_dev_info tool
|
|
448
419
|
curl -s -X POST https://YOUR-URL.railway.app/mcp \
|
|
449
420
|
-H "Content-Type: application/json" \
|
|
450
421
|
-H "Authorization: Bearer YOUR_API_KEY" \
|
|
@@ -453,7 +424,7 @@ curl -s -X POST https://YOUR-URL.railway.app/mcp \
|
|
|
453
424
|
"id":2,
|
|
454
425
|
"method":"tools/call",
|
|
455
426
|
"params":{
|
|
456
|
-
"name":"
|
|
427
|
+
"name":"Zephex_dev_info",
|
|
457
428
|
"arguments":{"url":"https://example.com"}
|
|
458
429
|
}
|
|
459
430
|
}' \
|
package/dist/cli.js
CHANGED
|
@@ -87,12 +87,21 @@ Add the following to your MCP config:
|
|
|
87
87
|
Get your API key at: https://zephex.dev/dashboard/api-keys
|
|
88
88
|
|
|
89
89
|
Config file locations:
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
Claude
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
90
|
+
VS Code: .vscode/mcp.json (uses "servers" key, not "mcpServers")
|
|
91
|
+
Cursor: .cursor/mcp.json
|
|
92
|
+
Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
|
|
93
|
+
Claude Desktop (Windows): %APPDATA%\\Claude\\claude_desktop_config.json
|
|
94
|
+
Claude Code: .mcp.json (or run: claude mcp add zephex -- npx -y zephex)
|
|
95
|
+
Windsurf: ~/.codeium/windsurf/mcp_config.json
|
|
96
|
+
JetBrains: Settings > Tools > AI Assistant > MCP
|
|
97
|
+
Zed: settings.json (uses "context_servers" key)
|
|
98
|
+
Gemini CLI: ~/.gemini/settings.json
|
|
99
|
+
Cline: cline_mcp_settings.json (via MCP Servers icon)
|
|
100
|
+
OpenCode: opencode.json (uses "mcp" key, type "local")
|
|
101
|
+
Codex CLI: ~/.codex/config.toml (TOML format)
|
|
102
|
+
Goose: goose configure > Add Extension
|
|
103
|
+
Factory AI: .factory/mcp.json (type "stdio" required)
|
|
104
|
+
Kiro CLI: .kiro/settings/mcp.json (uses "mcpServers" key, url for remote or command for local)
|
|
96
105
|
`);
|
|
97
106
|
process.exit(0);
|
|
98
107
|
}
|