penpot/mcp/packages/server/src/UserPenpotConnections.ts
Dr. Dominik Jain 8efbd9b5d3
🎉 Allow MCP to work with multiple files in parallel (#11927)
* 🎉 Add multi-file session routing to the MCP server

Session routing:
- Track each user's Penpot connections by session ID.
- Dispatch explicit sessions directly; otherwise discover the sole session.
- Return a retryable error when discovery fails or is incomplete.

Plugin and tools:
- Initialize connections with a fresh session ID and file metadata.
- Share the optional sessionId schema and place it last in tool inputs.

Validation:
- 84 tests, server type checking, and MCP formatting checks pass.
- Disable test logging to avoid the logging worker shutdown hang.

AI-assisted-by: gpt-6

* 🎉 Support independent MCP connections

- Require explicit connection intent for each integrated workspace.
- Derive short session IDs from the Penpot app instance and file.
- Show and copy session IDs in the MCP menu and standalone plugin UI.
- Stop stale callbacks and reconnect attempts after disconnect.

Validate with frontend and plugin tests, type checking, live multi-tab
checks, and standalone UI checks with a simulated connection. Server
tests pass with --test-force-exit; the normal runner can hang on shutdown.

AI-assisted-by: gpt-6

* 📚 Document multi-file MCP sessions

- Explain independent connections, session selection, and copying IDs.
- Describe session ID lifetimes for integrated and standalone plugins.
- Correct browser focus, connection, and recovery guidance.

Validate with the documentation site build and diff checks.

AI-assisted-by: gpt-6

* ✨ Change behavior on session ID duplication

* ✨ Open MCP toolbar menu on hover and match menu style

---------

Co-authored-by: alonso.torres <alonso.torres@kaleidos.net>
Co-authored-by: elhombretecla <delacruzgarciajuan@gmail.com>
2026-10-02 14:22:52 +02:00

44 lines
1.8 KiB
TypeScript

import type { PenpotSession } from "@penpot/mcp-common";
import type { PenpotConnection } from "./PenpotConnection";
import { WebSocket } from "ws";
/** Local Penpot connections belonging to one user, indexed by session ID. */
export class UserPenpotConnections {
private readonly connectionsBySessionId = new Map<string, PenpotConnection>();
get size(): number {
return this.connectionsBySessionId.size;
}
/** Registers a connection, returning the connection it replaces for the same session, if any. */
add(connection: PenpotConnection): PenpotConnection | undefined {
const { sessionId } = connection.session;
const replaced = this.connectionsBySessionId.get(sessionId);
this.connectionsBySessionId.set(sessionId, connection);
return replaced;
}
remove(connection: PenpotConnection): void {
const { sessionId } = connection.session;
if (this.connectionsBySessionId.get(sessionId) === connection) {
this.connectionsBySessionId.delete(sessionId);
}
}
/** Returns the registered connection for a session, whether or not it is ready. */
getRegistered(sessionId: string): PenpotConnection | undefined {
return this.connectionsBySessionId.get(sessionId);
}
get(sessionId: string): PenpotConnection | undefined {
const connection = this.connectionsBySessionId.get(sessionId);
return connection?.ready && connection.socket.readyState === WebSocket.OPEN ? connection : undefined;
}
getSessions(): PenpotSession[] {
return [...this.connectionsBySessionId.values()]
.filter((connection) => connection.ready && connection.socket.readyState === WebSocket.OPEN)
.map((connection) => ({ ...connection.session }));
}
}