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 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 (recommended)
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
- "AUTH_HEADER": "Bearer mcp_sk_your_api_key"
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 inspect_url
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=="inspect_url") | {name, title}'
416
+ | jq '.result.tools[] | select(.name=="Zephex_dev_info") | {name, title}'
446
417
 
447
- # Test 2: Run inspect_url tool
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":"inspect_url",
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
- Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
91
- Claude Desktop (Windows): %APPDATA%\\Claude\\claude_desktop_config.json
92
- Claude Code: ~/.claude/settings.json (under "mcpServers")
93
- Cursor: ~/.cursor/mcp.json
94
- Windsurf: ~/.codeium/windsurf/mcp_config.json
95
- Cline (VS Code): VS Code settings > Cline > MCP Servers
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
  }