linkbreakers-mcp 1.186.2 → 1.187.1

package/lib/client-header.js

@@ -0,0 +1,25 @@
+// The Linkbreakers-Client header the bridge sends to the MCP server:
+//   mcp-bridge/<version> (node <version>; <platform>; client=<name> <version>)
+// The client part names the MCP client on the other side of stdio, from its
+// initialize, so the server can count the end client and not just the bridge.
+// Nothing about the user or the machine beyond the OS family.
+
+const PLATFORMS = { darwin: 'darwin', linux: 'linux', win32: 'windows' };
+
+function clean(value, max) {
+  return String(value ?? '')
+    .replace(/[^A-Za-z0-9 ._+-]/g, '')
+    .trim()
+    .slice(0, max);
+}
+
+export function clientHeader(version, endClient) {
+  const platform = PLATFORMS[process.platform] ?? 'other';
+  const details = [`node ${process.versions.node}`, platform];
+  const name = clean(endClient?.name, 40);
+  if (name) {
+    const clientVersion = clean(endClient?.version, 24).replace(/ /g, '');
+    details.push(`client=${name}${clientVersion ? ` ${clientVersion}` : ''}`);
+  }
+  return `mcp-bridge/${clean(version, 24) || 'unknown'} (${details.join('; ')})`;
+}

package/lib/proxy.js

@@ -5,6 +5,7 @@ import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { McpError, ResultSchema } from '@modelcontextprotocol/sdk/types.js';
+import { clientHeader } from './client-header.js';
 import { FileOAuthProvider, hasStoredTokens, openBrowser } from './oauth.js';
 
 const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
@@ -23,7 +24,16 @@ export async function main() {
   let connecting;
   let signIn;
 
-  const transportOptions = { authProvider: oauth };
+  // The transport reads these headers on every request, so updating the
+  // object once the local MCP client has introduced itself is enough.
+  const requestHeaders = { 'Linkbreakers-Client': clientHeader(version) };
+  const transportOptions = { authProvider: oauth, requestInit: { headers: requestHeaders } };
+  // Also called before forwarding a request: a client that sends its first
+  // request right behind initialize can get there before the initialized
+  // notification is handled.
+  const nameLocalClient = () => {
+    requestHeaders['Linkbreakers-Client'] = clientHeader(version, server?.getClientVersion());
+  };
 
   async function connectRemote(transport = new StreamableHTTPClientTransport(SERVER_URL, transportOptions)) {
     const client = new Client({ name: 'linkbreakers-mcp', version }, { capabilities: {} });
@@ -103,6 +113,7 @@ export async function main() {
   );
 
   server.fallbackRequestHandler = async (request, extra) => {
+    nameLocalClient();
     const client = await ensureRemote();
     const progressToken = request.params?._meta?.progressToken;
     return client.request({ method: request.method, params: request.params }, ResultSchema, {
@@ -121,6 +132,8 @@ export async function main() {
     await remote?.notification(notification).catch(() => {});
   };
 
+  server.oninitialized = nameLocalClient;
+
   server.onclose = async () => {
     await remote?.close().catch(() => {});
     process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkbreakers-mcp",
-  "version": "1.186.2",
+  "version": "1.187.1",
   "mcpName": "com.linkbreakers/mcp",
   "description": "Local stdio bridge to the Linkbreakers MCP server (https://mcp.linkbreakers.com) for MCP clients that only run local servers.",
   "keywords": [