@maind-dev/mcp-bridge 0.85.0 → 0.87.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/README.md +38 -13
- package/build/index.js +290 -218
- package/build/meta.json +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
A tiny local MCP wrapper that pins your [maind](https://maind.dev) API key to
|
|
4
4
|
a single device. The bridge speaks MCP over stdio to your IDE (Claude Code,
|
|
5
|
-
Cursor, Windsurf, GitHub Copilot in VS Code, …) and forwards every request to `https://mcp.maind.dev/mcp`
|
|
5
|
+
Cursor, Windsurf, GitHub Copilot in VS Code, Cline, Continue, …) and forwards every request to `https://mcp.maind.dev/mcp`
|
|
6
6
|
with an `X-Maind-Device-Id` header, so the server can refuse calls from any
|
|
7
7
|
other machine that tries to reuse the same key.
|
|
8
8
|
|
|
@@ -94,6 +94,7 @@ again unless you re-pair).
|
|
|
94
94
|
| `npx -y @maind-dev/mcp-bridge` | Run as MCP server (default; what your IDE invokes) |
|
|
95
95
|
| `npx -y @maind-dev/mcp-bridge install` | One-shot setup: MCP configs, preamble files, Claude Code hooks |
|
|
96
96
|
| `npx -y @maind-dev/mcp-bridge --reauth` | Drop the cached key and re-run the device flow |
|
|
97
|
+
| `npx -y @maind-dev/mcp-bridge doctor` | Offline self-diagnosis with fix commands (`--json`; `--remove-phantoms [--yes]`, see below) |
|
|
97
98
|
| `npx -y @maind-dev/mcp-bridge --version` | Print the bridge version |
|
|
98
99
|
| `npx -y @maind-dev/mcp-bridge --help` | Show usage |
|
|
99
100
|
|
|
@@ -104,20 +105,44 @@ again unless you re-pair).
|
|
|
104
105
|
| Claude Code (project) | `<project>/.mcp.json` | always |
|
|
105
106
|
| Claude Code (user) | `~/.claude.json` | always |
|
|
106
107
|
| Claude Desktop | `claude_desktop_config.json` (per-OS path) | always |
|
|
107
|
-
| Cursor | `~/.cursor/mcp.json` |
|
|
108
|
-
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |
|
|
109
|
-
| GitHub Copilot (VS Code) | user-profile `mcp.json` (per-OS path, `servers` shape) | VS Code
|
|
108
|
+
| Cursor | `~/.cursor/mcp.json` | Cursor is installed, or `--client cursor` |
|
|
109
|
+
| Windsurf | `~/.codeium/windsurf/mcp_config.json` | Windsurf is installed, or `--client windsurf` |
|
|
110
|
+
| GitHub Copilot (VS Code) | user-profile `mcp.json` (per-OS path, `servers` shape) | VS Code is installed, or `--client copilot` |
|
|
111
|
+
| Cline | `~/.cline/data/settings/cline_mcp_settings.json` — one file for Cline in every editor, its CLI and Cline Desktop | Cline is installed, or `--client cline` |
|
|
112
|
+
| Continue | `~/.continue/mcpServers/maind.json` — a file of its own; `config.yaml` is never touched | Continue is installed, or `--client continue` |
|
|
110
113
|
| Codex CLI | `~/.codex/config.toml` | always, unless `--skip-codex` |
|
|
111
114
|
|
|
112
115
|
A client that is not installed gets no file of ours (since **0.85.0** for Cursor
|
|
113
|
-
and Windsurf, **0.83.0** for VS Code
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
116
|
+
and Windsurf, **0.83.0** for VS Code, **0.87.0** for Cline and Continue).
|
|
117
|
+
"Installed" means a trace only the client leaves, never a file or directory the
|
|
118
|
+
bridge writes itself (since **0.87.0** — bridges up to 0.84.0 wrote
|
|
119
|
+
`~/.cursor/mcp.json` and `~/.codeium/windsurf/mcp_config.json` on every
|
|
120
|
+
machine):
|
|
121
|
+
|
|
122
|
+
| Client | Counts as installed when |
|
|
123
|
+
|---|---|
|
|
124
|
+
| Cursor | its app data (`~/Library/Application Support/Cursor`, `%APPDATA%\Cursor`, `~/.config/Cursor`) holds more than `User/`, or `~/.cursor` holds more than `mcp.json` / `hooks.json` |
|
|
125
|
+
| Windsurf | its app data (`…/Windsurf`) holds more than `User/`, or `~/.codeium/windsurf` holds more than `mcp_config.json` |
|
|
126
|
+
| VS Code | its app data (`…/Code`) holds more than `User/` |
|
|
127
|
+
| Cline | `~/.cline/data` holds more than `settings/`, or an editor (Code, Code - Insiders, Cursor, VSCodium, Windsurf, AgentComposer) has Cline's `User/globalStorage/saoudrizwan.claude-dev` |
|
|
128
|
+
| Continue | `~/.continue` holds more than `mcpServers/` |
|
|
129
|
+
|
|
130
|
+
The report shows a skipped client as `skipped` with the reason (e.g. `Cursor
|
|
131
|
+
not found (no Cursor app data, nothing of Cursor's in ~/.cursor)`); when a
|
|
132
|
+
leftover file sits there, the row says so. The exit code stays 0.
|
|
133
|
+
Naming the family with `--client` is the explicit request that overrides the
|
|
134
|
+
probe. `CLINE_DIR`, `CLINE_DATA_DIR`, `CLINE_MCP_SETTINGS_PATH` and
|
|
135
|
+
`CONTINUE_GLOBAL_DIR` move the Cline and Continue files the way the clients
|
|
136
|
+
resolve them (absolute paths only).
|
|
137
|
+
|
|
138
|
+
### Leftover configs: `doctor --remove-phantoms`
|
|
139
|
+
|
|
140
|
+
`doctor` reports a config that names maind for a client that is not installed
|
|
141
|
+
as a **phantom** — nothing reads it. `doctor --remove-phantoms` lists what it
|
|
142
|
+
would do and changes nothing; `doctor --remove-phantoms --yes` applies the same
|
|
143
|
+
list. A file that holds only maind's entry is deleted; a file with anything
|
|
144
|
+
else in it (other servers, other keys, comments) loses only maind's entry,
|
|
145
|
+
every other byte stays.
|
|
121
146
|
|
|
122
147
|
### Claude Code hook subcommands
|
|
123
148
|
|
|
@@ -229,7 +254,7 @@ Rarely useful outside maind's own development environments:
|
|
|
229
254
|
| Variable | Default | Purpose |
|
|
230
255
|
|---|---|---|
|
|
231
256
|
| `MAIND_MCP_URL` | `https://mcp.maind.dev/mcp` | Streamable-HTTP endpoint to forward to |
|
|
232
|
-
| `MAIND_CLIENT_FAMILY` | unset | Forwards `X-Maind-Client-Family` (`claude-code`, `codex`, `copilot`, `cursor`, `windsurf`, …) so telemetry tracks the real upstream agent instead of generic `mcp-bridge` |
|
|
257
|
+
| `MAIND_CLIENT_FAMILY` | unset | Forwards `X-Maind-Client-Family` (`claude-code`, `codex`, `copilot`, `cursor`, `windsurf`, `cline`, `continue`, …) so telemetry tracks the real upstream agent instead of generic `mcp-bridge` |
|
|
233
258
|
| `MAIND_CLIENT_VERSION` | unset | Forwards optional `X-Maind-Client-Version` marker (max 64 chars) |
|
|
234
259
|
| `MAIND_FUNCTIONS_ORIGIN` | maind's Supabase Edge Functions URL | Device-flow base URL |
|
|
235
260
|
| `MAIND_NO_AGENTS_MD_REFRESH` | unset | Set to `1` to stop the bridge from refreshing the conventions block in `AGENTS.md` for Codex sessions (see above) |
|