@maind-dev/mcp-bridge 0.1.1 → 0.4.1
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 +19 -0
- package/build/client-detect.js +109 -0
- package/build/client-detect.js.map +1 -0
- package/build/forward.js +190 -12
- package/build/forward.js.map +1 -1
- package/build/index.js +20 -0
- package/build/index.js.map +1 -1
- package/build/install/atomic-write.js +115 -0
- package/build/install/atomic-write.js.map +1 -0
- package/build/install/browser-pair.js +139 -0
- package/build/install/browser-pair.js.map +1 -0
- package/build/install/client-targets.js +135 -0
- package/build/install/client-targets.js.map +1 -0
- package/build/install/flags.js +139 -0
- package/build/install/flags.js.map +1 -0
- package/build/install/hook-merge.js +195 -0
- package/build/install/hook-merge.js.map +1 -0
- package/build/install/index.js +187 -0
- package/build/install/index.js.map +1 -0
- package/build/install/json-merge.js +160 -0
- package/build/install/json-merge.js.map +1 -0
- package/build/install/preamble.js +119 -0
- package/build/install/preamble.js.map +1 -0
- package/build/install/project-root.js +120 -0
- package/build/install/project-root.js.map +1 -0
- package/build/install/report.js +89 -0
- package/build/install/report.js.map +1 -0
- package/build/install/telemetry.js +83 -0
- package/build/install/telemetry.js.map +1 -0
- package/build/install/toml-merge.js +148 -0
- package/build/install/toml-merge.js.map +1 -0
- package/build/version.js +1 -1
- package/package.json +13 -11
package/README.md
CHANGED
|
@@ -44,6 +44,23 @@ Add this to your MCP client's config (`.mcp.json` or equivalent):
|
|
|
44
44
|
}
|
|
45
45
|
```
|
|
46
46
|
|
|
47
|
+
If you want maind to attribute calls to the real upstream agent while still
|
|
48
|
+
using the bridge transport, add a client marker via env:
|
|
49
|
+
|
|
50
|
+
```json
|
|
51
|
+
{
|
|
52
|
+
"mcpServers": {
|
|
53
|
+
"maind": {
|
|
54
|
+
"command": "npx",
|
|
55
|
+
"args": ["-y", "@maind-dev/mcp-bridge"],
|
|
56
|
+
"env": {
|
|
57
|
+
"MAIND_CLIENT_FAMILY": "codex"
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
```
|
|
63
|
+
|
|
47
64
|
Restart the MCP client. The first invocation walks you through the device
|
|
48
65
|
flow; subsequent ones are silent (you should never see the verification code
|
|
49
66
|
again unless you re-pair).
|
|
@@ -95,6 +112,8 @@ Rarely useful outside maind's own development environments:
|
|
|
95
112
|
| Variable | Default | Purpose |
|
|
96
113
|
|---|---|---|
|
|
97
114
|
| `MAIND_MCP_URL` | `https://mcp.maind.dev/mcp` | Streamable-HTTP endpoint to forward to |
|
|
115
|
+
| `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` |
|
|
116
|
+
| `MAIND_CLIENT_VERSION` | unset | Forwards optional `X-Maind-Client-Version` marker (max 64 chars) |
|
|
98
117
|
| `MAIND_FUNCTIONS_ORIGIN` | maind's Supabase Edge Functions URL | Device-flow base URL |
|
|
99
118
|
| `XDG_CONFIG_HOME` | `~/.config` (Linux/BSD) | Parent of the `maind/` config dir |
|
|
100
119
|
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
// MIRROR of packages/types/src/client-families.ts — DO NOT EDIT IN ISOLATION.
|
|
2
|
+
//
|
|
3
|
+
// This file lives in the bridge package so the published npm artifact stays
|
|
4
|
+
// self-contained (no workspace runtime imports). The mapping MUST match the
|
|
5
|
+
// canonical version at packages/types/src/client-families.ts byte-for-byte
|
|
6
|
+
// (or at least value-for-value) — apps/mcp-bridge/test/client-detect.test.ts
|
|
7
|
+
// asserts data-equivalence and will fail CI on drift.
|
|
8
|
+
//
|
|
9
|
+
// When adding a new client family or rename pattern: update BOTH files in the
|
|
10
|
+
// same commit. The pre-commit hook (Block 5) catches diffs that touch
|
|
11
|
+
// apps/mcp-bridge/src/ without a corresponding package.json version bump,
|
|
12
|
+
// which is the failure mode that caused the multi-day Codex-as-mcp-bridge
|
|
13
|
+
// mis-attribution incident on 2026-05-24..28.
|
|
14
|
+
export const CLIENT_FAMILIES = [
|
|
15
|
+
"claude-code",
|
|
16
|
+
"codex",
|
|
17
|
+
"copilot",
|
|
18
|
+
"cursor",
|
|
19
|
+
"windsurf",
|
|
20
|
+
"mcp-bridge",
|
|
21
|
+
"vscode-extension",
|
|
22
|
+
"claude-desktop",
|
|
23
|
+
"mcp-inspector",
|
|
24
|
+
"maind-cli",
|
|
25
|
+
"unknown",
|
|
26
|
+
];
|
|
27
|
+
export const CLIENT_INFO_NAME_PATTERNS = [
|
|
28
|
+
// Anthropic
|
|
29
|
+
["claude-code", "claude-code"],
|
|
30
|
+
["claude-cli", "claude-code"],
|
|
31
|
+
["claude-desktop", "claude-desktop"],
|
|
32
|
+
["claude.app", "claude-desktop"],
|
|
33
|
+
// OpenAI
|
|
34
|
+
["openai-codex", "codex"],
|
|
35
|
+
["codex-cli", "codex"],
|
|
36
|
+
["codex", "codex"],
|
|
37
|
+
// GitHub / Microsoft
|
|
38
|
+
["github-copilot", "copilot"],
|
|
39
|
+
["vscode-copilot", "copilot"],
|
|
40
|
+
["copilot", "copilot"],
|
|
41
|
+
// Editors / IDE clients
|
|
42
|
+
["cursor", "cursor"],
|
|
43
|
+
["windsurf", "windsurf"],
|
|
44
|
+
["codeium", "windsurf"],
|
|
45
|
+
["vscode-extension", "vscode-extension"],
|
|
46
|
+
["maind-vscode", "vscode-extension"],
|
|
47
|
+
// Tooling
|
|
48
|
+
["mcp-inspector", "mcp-inspector"],
|
|
49
|
+
// Headless CI CLI (@maind-dev/cli — `maind context`). Matched before the
|
|
50
|
+
// bridge entry; "maind-cli" is not a substring of "maind-mcp-bridge".
|
|
51
|
+
["maind-cli", "maind-cli"],
|
|
52
|
+
// Bridge identifying itself explicitly (rare; usually we want the upstream client)
|
|
53
|
+
["maind-mcp-bridge", "mcp-bridge"],
|
|
54
|
+
];
|
|
55
|
+
export function mapClientInfoNameToFamily(rawName) {
|
|
56
|
+
if (typeof rawName !== "string")
|
|
57
|
+
return null;
|
|
58
|
+
const name = rawName.trim().toLowerCase();
|
|
59
|
+
if (name.length === 0)
|
|
60
|
+
return null;
|
|
61
|
+
for (const [pattern, family] of CLIENT_INFO_NAME_PATTERNS) {
|
|
62
|
+
if (name.includes(pattern))
|
|
63
|
+
return family;
|
|
64
|
+
}
|
|
65
|
+
return null;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* Parses an arbitrary string that the bridge is forwarding as a JSON-RPC frame
|
|
69
|
+
* and, if it's an MCP `initialize` request with a usable clientInfo.name,
|
|
70
|
+
* returns the canonical family + version. Returns null for everything else.
|
|
71
|
+
*
|
|
72
|
+
* Used by Forwarder.forwardFrame() to auto-detect the client family from the
|
|
73
|
+
* very first frame without requiring per-user MAIND_CLIENT_FAMILY config.
|
|
74
|
+
*
|
|
75
|
+
* Defensively try/catch: a malformed frame is normal (clients send all sorts
|
|
76
|
+
* of garbage); we never throw here. Worst case = null = no auto-detection.
|
|
77
|
+
*/
|
|
78
|
+
export function tryExtractInitializeClient(frame) {
|
|
79
|
+
let parsed;
|
|
80
|
+
try {
|
|
81
|
+
parsed = JSON.parse(frame);
|
|
82
|
+
}
|
|
83
|
+
catch {
|
|
84
|
+
return null;
|
|
85
|
+
}
|
|
86
|
+
if (!isRecord(parsed))
|
|
87
|
+
return null;
|
|
88
|
+
if (parsed.method !== "initialize")
|
|
89
|
+
return null;
|
|
90
|
+
const params = parsed.params;
|
|
91
|
+
if (!isRecord(params))
|
|
92
|
+
return null;
|
|
93
|
+
const clientInfo = params.clientInfo;
|
|
94
|
+
if (!isRecord(clientInfo))
|
|
95
|
+
return null;
|
|
96
|
+
const rawName = clientInfo.name;
|
|
97
|
+
const family = mapClientInfoNameToFamily(typeof rawName === "string" ? rawName : null);
|
|
98
|
+
if (family === null)
|
|
99
|
+
return null;
|
|
100
|
+
const rawVersion = clientInfo.version;
|
|
101
|
+
const version = typeof rawVersion === "string" && rawVersion.length > 0
|
|
102
|
+
? rawVersion.slice(0, 64)
|
|
103
|
+
: null;
|
|
104
|
+
return { family, version };
|
|
105
|
+
}
|
|
106
|
+
function isRecord(v) {
|
|
107
|
+
return typeof v === "object" && v !== null && !Array.isArray(v);
|
|
108
|
+
}
|
|
109
|
+
//# sourceMappingURL=client-detect.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client-detect.js","sourceRoot":"","sources":["../src/client-detect.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,6EAA6E;AAC7E,sDAAsD;AACtD,EAAE;AACF,8EAA8E;AAC9E,sEAAsE;AACtE,0EAA0E;AAC1E,0EAA0E;AAC1E,8CAA8C;AAE9C,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,aAAa;IACb,OAAO;IACP,SAAS;IACT,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,WAAW;IACX,SAAS;CACD,CAAC;AAIX,MAAM,CAAC,MAAM,yBAAyB,GAAmD;IACvF,YAAY;IACZ,CAAC,aAAa,EAAE,aAAa,CAAC;IAC9B,CAAC,YAAY,EAAE,aAAa,CAAC;IAC7B,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IACpC,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAEhC,SAAS;IACT,CAAC,cAAc,EAAE,OAAO,CAAC;IACzB,CAAC,WAAW,EAAE,OAAO,CAAC;IACtB,CAAC,OAAO,EAAE,OAAO,CAAC;IAElB,qBAAqB;IACrB,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAC7B,CAAC,gBAAgB,EAAE,SAAS,CAAC;IAC7B,CAAC,SAAS,EAAE,SAAS,CAAC;IAEtB,wBAAwB;IACxB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACpB,CAAC,UAAU,EAAE,UAAU,CAAC;IACxB,CAAC,SAAS,EAAE,UAAU,CAAC;IACvB,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IACxC,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAEpC,UAAU;IACV,CAAC,eAAe,EAAE,eAAe,CAAC;IAElC,yEAAyE;IACzE,sEAAsE;IACtE,CAAC,WAAW,EAAE,WAAW,CAAC;IAE1B,mFAAmF;IACnF,CAAC,kBAAkB,EAAE,YAAY,CAAC;CAC1B,CAAC;AAEX,MAAM,UAAU,yBAAyB,CACvC,OAAkC;IAElC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,KAAK,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,yBAAyB,EAAE,CAAC;QAC1D,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,OAAO,MAAM,CAAC;IAC5C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,KAAa;IAEb,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY;QAAE,OAAO,IAAI,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,yBAAyB,CACtC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAC7C,CAAC;IACF,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC;IACtC,MAAM,OAAO,GACX,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;QACrD,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACzB,CAAC,CAAC,IAAI,CAAC;IACX,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}
|
package/build/forward.js
CHANGED
|
@@ -13,6 +13,7 @@
|
|
|
13
13
|
// unpacked to JSON-RPC frames on stdout.
|
|
14
14
|
import { createInterface } from "node:readline";
|
|
15
15
|
import { setTimeout as delay } from "node:timers/promises";
|
|
16
|
+
import { tryExtractInitializeClient } from "./client-detect.js";
|
|
16
17
|
/**
|
|
17
18
|
* Default Streamable-HTTP MCP endpoint for the production maind server.
|
|
18
19
|
* Override via env `MAIND_MCP_URL` for self-hosted/preview environments.
|
|
@@ -36,14 +37,41 @@ export class Forwarder {
|
|
|
36
37
|
apiKey;
|
|
37
38
|
deviceId;
|
|
38
39
|
bridgeVersion;
|
|
40
|
+
/**
|
|
41
|
+
* Mutable because auto-detection from the MCP `initialize` frame can fill it
|
|
42
|
+
* in for clients that didn't set MAIND_CLIENT_FAMILY. Constructor/ENV values
|
|
43
|
+
* remain authoritative — auto-detect only writes when both are absent.
|
|
44
|
+
*/
|
|
45
|
+
clientFamily;
|
|
46
|
+
clientVersion;
|
|
47
|
+
/**
|
|
48
|
+
* True once we've explicitly set clientFamily via constructor arg or ENV.
|
|
49
|
+
* Used to lock out auto-detect overwrites (priority chain documented in
|
|
50
|
+
* client-detect.ts).
|
|
51
|
+
*/
|
|
52
|
+
clientFamilyLocked;
|
|
53
|
+
clientVersionLocked;
|
|
39
54
|
/** Set by the first response that carries an Mcp-Session-Id header. */
|
|
40
55
|
sessionId = null;
|
|
56
|
+
/**
|
|
57
|
+
* The MCP `initialize` request frame, cached the first time we forward it.
|
|
58
|
+
* Replayed to transparently re-establish a session after the server drops it
|
|
59
|
+
* (HTTP 404 "session expired", e.g. after a server restart/deploy) so a
|
|
60
|
+
* deploy doesn't surface as a hard error to the local client.
|
|
61
|
+
*/
|
|
62
|
+
initFrame = null;
|
|
41
63
|
/** Set true once an unrecoverable auth condition is detected. */
|
|
42
64
|
terminated = false;
|
|
43
65
|
constructor(cfg) {
|
|
44
66
|
this.apiKey = cfg.apiKey;
|
|
45
67
|
this.deviceId = cfg.deviceId;
|
|
46
68
|
this.bridgeVersion = cfg.bridgeVersion;
|
|
69
|
+
const rawFamily = cfg.clientFamily ?? process.env.MAIND_CLIENT_FAMILY ?? null;
|
|
70
|
+
this.clientFamily = normalizeClientFamily(rawFamily);
|
|
71
|
+
this.clientFamilyLocked = this.clientFamily !== null;
|
|
72
|
+
const rawVersion = cfg.clientVersion ?? process.env.MAIND_CLIENT_VERSION ?? null;
|
|
73
|
+
this.clientVersion = normalizeClientVersion(rawVersion);
|
|
74
|
+
this.clientVersionLocked = this.clientVersion !== null;
|
|
47
75
|
this.mcpUrl =
|
|
48
76
|
cfg.mcpUrl ??
|
|
49
77
|
process.env.MAIND_MCP_URL ??
|
|
@@ -73,19 +101,27 @@ export class Forwarder {
|
|
|
73
101
|
await this.forwardFrame(trimmed);
|
|
74
102
|
}
|
|
75
103
|
}
|
|
76
|
-
async forwardFrame(frame) {
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
104
|
+
async forwardFrame(frame, isRetry = false) {
|
|
105
|
+
// Auto-detect upstream client from the MCP `initialize` frame. Runs once
|
|
106
|
+
// per session — initialize is always the first JSON-RPC method. ENV /
|
|
107
|
+
// constructor values win (locked flags), so user overrides remain
|
|
108
|
+
// authoritative. See client-detect.ts for the full priority chain.
|
|
109
|
+
if (!this.clientFamilyLocked && this.clientFamily === null) {
|
|
110
|
+
const detected = tryExtractInitializeClient(frame);
|
|
111
|
+
if (detected !== null) {
|
|
112
|
+
this.clientFamily = detected.family;
|
|
113
|
+
if (!this.clientVersionLocked && this.clientVersion === null) {
|
|
114
|
+
this.clientVersion = detected.version;
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
// Cache the initialize frame the first time we see it so we can replay it to
|
|
119
|
+
// recover a dropped session (see recoverSession). Only the first initialize
|
|
120
|
+
// matters — it carries the client's capabilities + clientInfo.
|
|
121
|
+
if (this.initFrame === null && isInitializeRequest(frame)) {
|
|
122
|
+
this.initFrame = frame;
|
|
88
123
|
}
|
|
124
|
+
const headers = this.buildHeaders(true);
|
|
89
125
|
let response;
|
|
90
126
|
try {
|
|
91
127
|
response = await fetch(this.mcpUrl, {
|
|
@@ -113,6 +149,27 @@ export class Forwarder {
|
|
|
113
149
|
await this.handle401(response, frame);
|
|
114
150
|
return;
|
|
115
151
|
}
|
|
152
|
+
// Session recovery: a 404 on a request that carried a session-id means the
|
|
153
|
+
// server no longer knows the session (typically a restart/deploy wiped its
|
|
154
|
+
// in-memory session map). Per the MCP spec the client must start a new
|
|
155
|
+
// session. We do it transparently — replay the cached initialize for a fresh
|
|
156
|
+
// session-id, then retry the original frame ONCE (isRetry guards the loop).
|
|
157
|
+
// Without this, every server deploy surfaces to the local client as a hard
|
|
158
|
+
// error until the bridge process is restarted.
|
|
159
|
+
if (response.status === 404 &&
|
|
160
|
+
!isRetry &&
|
|
161
|
+
this.initFrame !== null &&
|
|
162
|
+
this.sessionId !== null &&
|
|
163
|
+
!isInitializeRequest(frame)) {
|
|
164
|
+
const body = await response.text().catch(() => "");
|
|
165
|
+
if (isSessionLossBody(body) && (await this.recoverSession())) {
|
|
166
|
+
await this.forwardFrame(frame, true);
|
|
167
|
+
return;
|
|
168
|
+
}
|
|
169
|
+
const id = tryExtractId(frame);
|
|
170
|
+
emitJsonRpcError(id, -32603, `bridge upstream error (HTTP 404): ${body.slice(0, 500)}`);
|
|
171
|
+
return;
|
|
172
|
+
}
|
|
116
173
|
if (!response.ok) {
|
|
117
174
|
const id = tryExtractId(frame);
|
|
118
175
|
const body = await response.text().catch(() => "");
|
|
@@ -154,6 +211,104 @@ export class Forwarder {
|
|
|
154
211
|
const id = tryExtractId(frame);
|
|
155
212
|
emitJsonRpcError(id, -32001, `bridge auth error: ${body.slice(0, 200)}`);
|
|
156
213
|
}
|
|
214
|
+
/**
|
|
215
|
+
* Build the outbound header set. `includeSession` attaches the current
|
|
216
|
+
* Mcp-Session-Id (when set) — pass false for the recovery initialize, which
|
|
217
|
+
* must NOT carry the dead session-id so the server mints a fresh one.
|
|
218
|
+
*/
|
|
219
|
+
buildHeaders(includeSession) {
|
|
220
|
+
const headers = {
|
|
221
|
+
"content-type": "application/json",
|
|
222
|
+
// Streamable HTTP allows either a one-shot JSON body or an SSE stream
|
|
223
|
+
// back. Advertising both lets the server pick.
|
|
224
|
+
"accept": "application/json, text/event-stream",
|
|
225
|
+
"authorization": `Bearer ${this.apiKey}`,
|
|
226
|
+
"x-maind-device-id": this.deviceId,
|
|
227
|
+
"x-maind-bridge-version": this.bridgeVersion,
|
|
228
|
+
};
|
|
229
|
+
if (this.clientFamily !== null) {
|
|
230
|
+
headers["x-maind-client-family"] = this.clientFamily;
|
|
231
|
+
}
|
|
232
|
+
if (this.clientVersion !== null) {
|
|
233
|
+
headers["x-maind-client-version"] = this.clientVersion;
|
|
234
|
+
}
|
|
235
|
+
if (includeSession && this.sessionId !== null) {
|
|
236
|
+
headers["mcp-session-id"] = this.sessionId;
|
|
237
|
+
}
|
|
238
|
+
return headers;
|
|
239
|
+
}
|
|
240
|
+
/**
|
|
241
|
+
* Re-establish a session after the server dropped it. Replays the cached
|
|
242
|
+
* initialize frame (without a session-id) to mint a fresh Mcp-Session-Id, then
|
|
243
|
+
* sends the readiness notification — mirroring the original handshake. Both
|
|
244
|
+
* responses are drained but NEVER written to stdout: the local client already
|
|
245
|
+
* completed its handshake and must not see a duplicate initialize result.
|
|
246
|
+
* Returns true iff a new session-id was obtained.
|
|
247
|
+
*/
|
|
248
|
+
async recoverSession() {
|
|
249
|
+
if (this.initFrame === null)
|
|
250
|
+
return false;
|
|
251
|
+
this.sessionId = null; // drop the dead session before re-initializing
|
|
252
|
+
let res;
|
|
253
|
+
try {
|
|
254
|
+
res = await fetch(this.mcpUrl, {
|
|
255
|
+
method: "POST",
|
|
256
|
+
headers: this.buildHeaders(false),
|
|
257
|
+
body: this.initFrame,
|
|
258
|
+
});
|
|
259
|
+
}
|
|
260
|
+
catch {
|
|
261
|
+
return false;
|
|
262
|
+
}
|
|
263
|
+
const sid = res.headers.get("mcp-session-id");
|
|
264
|
+
await res.text().catch(() => ""); // drain, never emit
|
|
265
|
+
if (!res.ok || !sid)
|
|
266
|
+
return false;
|
|
267
|
+
this.sessionId = sid;
|
|
268
|
+
// Best-effort readiness notification on the new session (fire-and-forget).
|
|
269
|
+
try {
|
|
270
|
+
const notify = await fetch(this.mcpUrl, {
|
|
271
|
+
method: "POST",
|
|
272
|
+
headers: this.buildHeaders(true),
|
|
273
|
+
body: JSON.stringify({
|
|
274
|
+
jsonrpc: "2.0",
|
|
275
|
+
method: "notifications/initialized",
|
|
276
|
+
}),
|
|
277
|
+
});
|
|
278
|
+
await notify.text().catch(() => "");
|
|
279
|
+
}
|
|
280
|
+
catch {
|
|
281
|
+
// Advisory only — tool calls work off the session-id alone.
|
|
282
|
+
}
|
|
283
|
+
return true;
|
|
284
|
+
}
|
|
285
|
+
}
|
|
286
|
+
function normalizeClientFamily(raw) {
|
|
287
|
+
if (raw === null)
|
|
288
|
+
return null;
|
|
289
|
+
const v = raw.trim().toLowerCase();
|
|
290
|
+
if (v.length === 0)
|
|
291
|
+
return null;
|
|
292
|
+
const allowed = new Set([
|
|
293
|
+
"claude-code",
|
|
294
|
+
"codex",
|
|
295
|
+
"copilot",
|
|
296
|
+
"cursor",
|
|
297
|
+
"windsurf",
|
|
298
|
+
"mcp-bridge",
|
|
299
|
+
"vscode-extension",
|
|
300
|
+
"claude-desktop",
|
|
301
|
+
"mcp-inspector",
|
|
302
|
+
]);
|
|
303
|
+
return allowed.has(v) ? v : null;
|
|
304
|
+
}
|
|
305
|
+
function normalizeClientVersion(raw) {
|
|
306
|
+
if (raw === null)
|
|
307
|
+
return null;
|
|
308
|
+
const v = raw.trim();
|
|
309
|
+
if (v.length === 0)
|
|
310
|
+
return null;
|
|
311
|
+
return v.slice(0, 64);
|
|
157
312
|
}
|
|
158
313
|
/**
|
|
159
314
|
* Streams an SSE response body and emits each `data:` payload as a single
|
|
@@ -218,6 +373,29 @@ function tryExtractId(frame) {
|
|
|
218
373
|
return null;
|
|
219
374
|
}
|
|
220
375
|
}
|
|
376
|
+
/** True if the frame is a JSON-RPC MCP `initialize` request. */
|
|
377
|
+
function isInitializeRequest(frame) {
|
|
378
|
+
try {
|
|
379
|
+
return JSON.parse(frame).method === "initialize";
|
|
380
|
+
}
|
|
381
|
+
catch {
|
|
382
|
+
return false;
|
|
383
|
+
}
|
|
384
|
+
}
|
|
385
|
+
/**
|
|
386
|
+
* Heuristic: does a 404 body indicate the server lost our session (vs. a
|
|
387
|
+
* genuinely wrong endpoint)? Matches the maind server's session-expired message
|
|
388
|
+
* and generic MCP wording. Conservative — only a clear session-loss signal
|
|
389
|
+
* triggers recovery, so an unrelated 404 still surfaces as an error.
|
|
390
|
+
*/
|
|
391
|
+
function isSessionLossBody(body) {
|
|
392
|
+
const lower = body.toLowerCase();
|
|
393
|
+
return (lower.includes("session not found") ||
|
|
394
|
+
lower.includes("session expired") ||
|
|
395
|
+
lower.includes("no valid session") ||
|
|
396
|
+
lower.includes("reinitialize") ||
|
|
397
|
+
(lower.includes("session") && lower.includes("expired")));
|
|
398
|
+
}
|
|
221
399
|
function stringifyErr(err) {
|
|
222
400
|
if (err instanceof Error)
|
|
223
401
|
return err.message;
|
package/build/forward.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"forward.js","sourceRoot":"","sources":["../src/forward.ts"],"names":[],"mappings":"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"}
|
package/build/index.js
CHANGED
|
@@ -18,6 +18,7 @@ import { BridgeReauthNeeded, Forwarder } from "./forward.js";
|
|
|
18
18
|
import { clearApiKey, ensureDeviceId, readApiKey, writeApiKey, } from "./device-id.js";
|
|
19
19
|
import { runDeviceFlow } from "./auth.js";
|
|
20
20
|
import { BRIDGE_VERSION } from "./version.js";
|
|
21
|
+
import { runInstall } from "./install/index.js";
|
|
21
22
|
const MAX_REAUTH_ATTEMPTS = 1;
|
|
22
23
|
/**
|
|
23
24
|
* Resolves the API key to use for this run, in priority order:
|
|
@@ -66,6 +67,19 @@ async function reauth() {
|
|
|
66
67
|
return result.apiKey;
|
|
67
68
|
}
|
|
68
69
|
async function main() {
|
|
70
|
+
// Sub-command dispatch — the first non-flag positional argument selects a
|
|
71
|
+
// mode. With no sub-command we fall through to the original bridge-proxy
|
|
72
|
+
// behavior (stdin↔HTTP forwarding for MCP).
|
|
73
|
+
const firstPositional = process.argv
|
|
74
|
+
.slice(2)
|
|
75
|
+
.find((a) => !a.startsWith("-"));
|
|
76
|
+
if (firstPositional === "install") {
|
|
77
|
+
// Forward everything AFTER the "install" token to the install handler.
|
|
78
|
+
const installIndex = process.argv.indexOf("install");
|
|
79
|
+
const installArgs = process.argv.slice(installIndex + 1);
|
|
80
|
+
const code = await runInstall(installArgs);
|
|
81
|
+
process.exit(code);
|
|
82
|
+
}
|
|
69
83
|
if (process.argv.includes("--version") || process.argv.includes("-v")) {
|
|
70
84
|
process.stdout.write(BRIDGE_VERSION + "\n");
|
|
71
85
|
process.exit(0);
|
|
@@ -116,12 +130,18 @@ function printHelp() {
|
|
|
116
130
|
"",
|
|
117
131
|
"Usage:",
|
|
118
132
|
" npx -y @maind-dev/mcp-bridge # run as MCP server (stdio)",
|
|
133
|
+
" npx -y @maind-dev/mcp-bridge install # one-shot setup (configs, preamble, hook)",
|
|
119
134
|
" npx -y @maind-dev/mcp-bridge --reauth # discard local key and re-run device flow",
|
|
120
135
|
" npx -y @maind-dev/mcp-bridge --version",
|
|
121
136
|
" npx -y @maind-dev/mcp-bridge --help",
|
|
122
137
|
"",
|
|
138
|
+
"Run `install --help` for full setup flags:",
|
|
139
|
+
" npx -y @maind-dev/mcp-bridge install --help",
|
|
140
|
+
"",
|
|
123
141
|
"Environment overrides (rarely needed):",
|
|
124
142
|
" MAIND_MCP_URL Streamable-HTTP endpoint (default https://mcp.maind.dev/mcp)",
|
|
143
|
+
" MAIND_CLIENT_FAMILY Forward real client family (claude-code|codex|copilot|cursor|windsurf|...)",
|
|
144
|
+
" MAIND_CLIENT_VERSION Optional client version marker (max 64 chars)",
|
|
125
145
|
" MAIND_FUNCTIONS_ORIGIN Supabase Edge Functions base URL for device-auth",
|
|
126
146
|
" XDG_CONFIG_HOME Override config-dir parent on Linux/BSD",
|
|
127
147
|
"",
|
package/build/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,uCAAuC;AACvC,EAAE;AACF,aAAa;AACb,2EAA2E;AAC3E,+EAA+E;AAC/E,iFAAiF;AACjF,gEAAgE;AAChE,gFAAgF;AAChF,iFAAiF;AACjF,2EAA2E;AAC3E,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAE3E,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EACL,WAAW,EACX,cAAc,EACd,UAAU,EACV,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
// Cross-platform atomic file write + small fs/path helpers used across the
|
|
2
|
+
// install sub-command. Centralized so platform quirks live in one place.
|
|
3
|
+
//
|
|
4
|
+
// Atomic-write strategy:
|
|
5
|
+
// 1. Write to a sibling tmp file in the same directory.
|
|
6
|
+
// 2. fs.rename() the tmp file into place — atomic on POSIX, mostly-atomic on
|
|
7
|
+
// Windows when the target doesn't exist.
|
|
8
|
+
// 3. Windows fallback: if rename fails with EEXIST/EPERM, copy + unlink.
|
|
9
|
+
//
|
|
10
|
+
// The "write to sibling" detail matters: rename across filesystems isn't
|
|
11
|
+
// atomic and may fail (EXDEV). Using $TMPDIR could land us on a tmpfs that's
|
|
12
|
+
// a different filesystem than the target.
|
|
13
|
+
import * as fs from "node:fs/promises";
|
|
14
|
+
import * as path from "node:path";
|
|
15
|
+
/**
|
|
16
|
+
* Reads a UTF-8 file. Returns `null` if the file does not exist. Re-throws
|
|
17
|
+
* any other error (permission denied, IO error, etc.) so the caller can
|
|
18
|
+
* record it as a failed step.
|
|
19
|
+
*/
|
|
20
|
+
export async function readFileSafe(filepath) {
|
|
21
|
+
try {
|
|
22
|
+
return await fs.readFile(filepath, "utf8");
|
|
23
|
+
}
|
|
24
|
+
catch (err) {
|
|
25
|
+
if (isNoEnt(err))
|
|
26
|
+
return null;
|
|
27
|
+
throw err;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
export async function fileExists(filepath) {
|
|
31
|
+
try {
|
|
32
|
+
await fs.access(filepath);
|
|
33
|
+
return true;
|
|
34
|
+
}
|
|
35
|
+
catch {
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Idempotent `mkdir -p`. Creates the directory and any missing parents.
|
|
41
|
+
* Returns silently if the directory already exists.
|
|
42
|
+
*/
|
|
43
|
+
export async function ensureDir(dir) {
|
|
44
|
+
await fs.mkdir(dir, { recursive: true });
|
|
45
|
+
}
|
|
46
|
+
/**
|
|
47
|
+
* Writes `content` to `filepath` atomically across macOS, Linux, and Windows.
|
|
48
|
+
*
|
|
49
|
+
* @param mode Optional POSIX file mode (e.g. 0o600 for user-private files).
|
|
50
|
+
* No-op on Windows where mode bits don't translate to ACLs.
|
|
51
|
+
*/
|
|
52
|
+
export async function atomicWriteFile(filepath, content, mode) {
|
|
53
|
+
const dir = path.dirname(filepath);
|
|
54
|
+
await ensureDir(dir);
|
|
55
|
+
// Sibling tmp file — same FS as the target, so rename is atomic.
|
|
56
|
+
const tmp = path.join(dir, `.maind-install-${process.pid}-${Date.now()}.tmp`);
|
|
57
|
+
await fs.writeFile(tmp, content, { encoding: "utf8", mode });
|
|
58
|
+
try {
|
|
59
|
+
await fs.rename(tmp, filepath);
|
|
60
|
+
}
|
|
61
|
+
catch (err) {
|
|
62
|
+
// Windows: rename can fail with EEXIST/EPERM when the target exists or is
|
|
63
|
+
// locked. Fallback: copy + unlink. This is NOT atomic — but the alternative
|
|
64
|
+
// (fail the whole install) is worse, and we minimize the window by doing
|
|
65
|
+
// it just for the one file.
|
|
66
|
+
if (isWindowsRenameFailure(err)) {
|
|
67
|
+
try {
|
|
68
|
+
await fs.copyFile(tmp, filepath);
|
|
69
|
+
await fs.unlink(tmp).catch(() => {
|
|
70
|
+
// tmp cleanup best-effort — leaking a tmp file is harmless
|
|
71
|
+
});
|
|
72
|
+
if (mode !== undefined) {
|
|
73
|
+
await fs.chmod(filepath, mode).catch(() => {
|
|
74
|
+
// chmod no-op on Windows is fine
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
return;
|
|
78
|
+
}
|
|
79
|
+
catch (fallbackErr) {
|
|
80
|
+
await fs.unlink(tmp).catch(() => { });
|
|
81
|
+
throw fallbackErr;
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
await fs.unlink(tmp).catch(() => { });
|
|
85
|
+
throw err;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* Checks whether a file already contains a line that starts with the given
|
|
90
|
+
* marker (anchored to the start of a line). Used by the preamble-file logic
|
|
91
|
+
* to detect "## maind MCP integration" without false-matching nested headings.
|
|
92
|
+
*
|
|
93
|
+
* Returns `false` if the file does not exist.
|
|
94
|
+
*/
|
|
95
|
+
export async function hasLinePrefix(filepath, prefix) {
|
|
96
|
+
const content = await readFileSafe(filepath);
|
|
97
|
+
if (content === null)
|
|
98
|
+
return false;
|
|
99
|
+
const lines = content.split(/\r?\n/);
|
|
100
|
+
return lines.some((l) => l.startsWith(prefix));
|
|
101
|
+
}
|
|
102
|
+
function isNoEnt(err) {
|
|
103
|
+
return isNodeError(err) && err.code === "ENOENT";
|
|
104
|
+
}
|
|
105
|
+
function isWindowsRenameFailure(err) {
|
|
106
|
+
if (!isNodeError(err))
|
|
107
|
+
return false;
|
|
108
|
+
if (process.platform !== "win32")
|
|
109
|
+
return false;
|
|
110
|
+
return err.code === "EEXIST" || err.code === "EPERM" || err.code === "EACCES";
|
|
111
|
+
}
|
|
112
|
+
function isNodeError(err) {
|
|
113
|
+
return typeof err === "object" && err !== null && "code" in err;
|
|
114
|
+
}
|
|
115
|
+
//# sourceMappingURL=atomic-write.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../src/install/atomic-write.ts"],"names":[],"mappings":"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"}
|