@debugbundle/mcp 1.6.3 → 1.8.0
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/LICENSE +202 -661
- package/README.md +26 -25
- package/dist/main.cjs +87954 -21547
- package/package.json +9 -3
- package/server.json +2 -2
package/README.md
CHANGED
|
@@ -36,18 +36,18 @@ Use `npx -y @debugbundle/mcp` in clients that require noninteractive package exe
|
|
|
36
36
|
|
|
37
37
|
## Install Matrix
|
|
38
38
|
|
|
39
|
-
| Environment
|
|
40
|
-
|
|
|
41
|
-
| Generic local MCP client
|
|
42
|
-
| Claude Desktop local MCP
|
|
43
|
-
| Claude Code plugin
|
|
44
|
-
| Cursor
|
|
45
|
-
| VS Code / GitHub MCP Registry | `com.debugbundle/mcp`
|
|
46
|
-
| OpenClaw / ClawHub
|
|
47
|
-
| CI/headless agents
|
|
48
|
-
| Self-hosted DebugBundle
|
|
49
|
-
|
|
50
|
-
|
|
39
|
+
| Environment | Recommended path | Notes |
|
|
40
|
+
| ----------------------------- | ------------------------------------------------- | ------------------------------------------------- |
|
|
41
|
+
| Generic local MCP client | `npx @debugbundle/mcp` | stdio transport |
|
|
42
|
+
| Claude Desktop local MCP | local MCP server config | uses local machine auth/config |
|
|
43
|
+
| Claude Code plugin | `/plugin marketplace add debugbundle/debugbundle` | installs bundled MCP config and DebugBundle skill |
|
|
44
|
+
| Cursor | MCP config with `npx @debugbundle/mcp` | stdio transport |
|
|
45
|
+
| VS Code / GitHub MCP Registry | `com.debugbundle/mcp` | official registry metadata |
|
|
46
|
+
| OpenClaw / ClawHub | DebugBundle skill plus MCP config | use the published skill for workflow guidance |
|
|
47
|
+
| CI/headless agents | `DEBUGBUNDLE_MEMBER_TOKEN` | never use a project token |
|
|
48
|
+
| Self-hosted DebugBundle | `DEBUGBUNDLE_API_URL` plus member auth | points the server at your API base URL |
|
|
49
|
+
|
|
50
|
+
This package is the supported public local stdio path. A separate OpenAI Plugin `1.0.0` source candidate targets an OAuth-protected read-only remote endpoint at `https://mcp.debugbundle.com/mcp`; it is not deployed, submitted, published, or publicly installable yet and does not alter this package's catalog or authentication.
|
|
51
51
|
|
|
52
52
|
## Claude Desktop
|
|
53
53
|
|
|
@@ -79,12 +79,12 @@ The plugin package lives at `apps/mcp/claude-code/debugbundle`, bundles a Claude
|
|
|
79
79
|
|
|
80
80
|
## Authentication
|
|
81
81
|
|
|
82
|
-
| Mode
|
|
83
|
-
|
|
|
84
|
-
| CLI auth state
|
|
82
|
+
| Mode | Use | Notes |
|
|
83
|
+
| -------------------------- | --------------------------------------- | ----------------------------------------------------------------- |
|
|
84
|
+
| CLI auth state | Local developer machines | Reuses `~/.debugbundle/auth.json` when available. |
|
|
85
85
|
| `DEBUGBUNDLE_MEMBER_TOKEN` | Headless or marketplace-managed clients | Member tokens are for CLI/API/MCP read and management operations. |
|
|
86
|
-
| Per-tool `bearerToken`
|
|
87
|
-
| Project token
|
|
86
|
+
| Per-tool `bearerToken` | Explicit advanced automation | Overrides default auth for that call only. |
|
|
87
|
+
| Project token | SDK ingestion only | Do not use project tokens for MCP retrieval or management. |
|
|
88
88
|
|
|
89
89
|
## What Agents Can Do
|
|
90
90
|
|
|
@@ -102,12 +102,12 @@ For analytics questions, use direct aggregate tools first and generate an Analyt
|
|
|
102
102
|
|
|
103
103
|
## Troubleshooting
|
|
104
104
|
|
|
105
|
-
| Symptom
|
|
106
|
-
|
|
|
107
|
-
| Node.js launch failure
|
|
108
|
-
| Missing local auth
|
|
109
|
-
| Invalid token
|
|
110
|
-
| Wrong API host
|
|
105
|
+
| Symptom | Check |
|
|
106
|
+
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
|
|
107
|
+
| Node.js launch failure | Use Node.js 22.x through 26.x. Configure the client to use a supported `node` or `npx` runtime. |
|
|
108
|
+
| Missing local auth | Run `debugbundle login`, or set `DEBUGBUNDLE_MEMBER_TOKEN` for headless and managed clients. |
|
|
109
|
+
| Invalid token | Use a `dbundle_mem_` member token. Project tokens are SDK ingestion-only credentials. |
|
|
110
|
+
| Wrong API host | Leave `DEBUGBUNDLE_API_URL` unset for DebugBundle Cloud; set it only for self-hosted or non-default API hosts. |
|
|
111
111
|
| Local repo not initialized | Run `debugbundle setup` before local-only diagnostics, local bundle analysis, or generated project-skill workflows. |
|
|
112
112
|
|
|
113
113
|
## Links
|
|
@@ -116,6 +116,7 @@ For analytics questions, use direct aggregate tools first and generate an Analyt
|
|
|
116
116
|
- Agent workflows: https://debugbundle.com/docs/agent-workflows
|
|
117
117
|
- LLM index: https://debugbundle.com/llms.txt
|
|
118
118
|
- MCP tool schema: https://debugbundle.com/schemas/mcp-tools.json
|
|
119
|
+
- OpenAI Plugin candidate: https://debugbundle.com/docs/mcp/openai-plugin
|
|
119
120
|
- Official MCP Registry metadata: https://github.com/debugbundle/debugbundle/blob/main/apps/mcp/server.json
|
|
120
121
|
|
|
121
122
|
## Security And Trust
|
|
@@ -123,10 +124,10 @@ For analytics questions, use direct aggregate tools first and generate an Analyt
|
|
|
123
124
|
- Official MCP Registry name: `com.debugbundle/mcp`.
|
|
124
125
|
- Official npm package: `@debugbundle/mcp`.
|
|
125
126
|
- Source repository: https://github.com/debugbundle/debugbundle/tree/main/apps/mcp
|
|
126
|
-
- License:
|
|
127
|
+
- License: Apache-2.0.
|
|
127
128
|
- The server uses stdio transport and local process credentials. It does not include hidden hosted management auth.
|
|
128
129
|
- Public examples must use placeholders only; never paste real member tokens, project tokens, webhook secrets, or customer configuration into marketplace listings.
|
|
129
130
|
|
|
130
131
|
## License
|
|
131
132
|
|
|
132
|
-
|
|
133
|
+
Apache-2.0.
|