McpSessionManager

@webda/mcp

---

Class: McpSessionManager

Defined in: packages/mcp/src/sessions.ts:37

In-memory MCP sessions with idle eviction

Constructors

Constructor

new McpSessionManager(timeoutMs, now?): McpSessionManager

Defined in: packages/mcp/src/sessions.ts:48

Create a new McpSessionManager instance

Parameters

timeoutMs

number

idle time before eviction

now?

() => number

clock (injectable for tests)

Returns

McpSessionManager

Properties

now

protected now: () => number

Defined in: packages/mcp/src/sessions.ts:50

clock (injectable for tests)

Returns

number

---

sessions

protected sessions: Map<string, McpSessionEntry>

Defined in: packages/mcp/src/sessions.ts:41

Sessions

---

timeoutMs

protected timeoutMs: number

Defined in: packages/mcp/src/sessions.ts:49

idle time before eviction

Methods

add()

add(entry): void

Defined in: packages/mcp/src/sessions.ts:57

Add operation

Parameters

entry

McpSessionEntry

session to track

Returns

void

---

all()

all(): McpSessionEntry[]

Defined in: packages/mcp/src/sessions.ts:87

Return all sessions

Returns

McpSessionEntry[]

all sessions

---

close()

protected close(entry): Promise<void>

Defined in: packages/mcp/src/sessions.ts:141

Close operation

Parameters

entry

McpSessionEntry

session to close and remove

Returns

Promise<void>

---

closeAll()

closeAll(): Promise<void>

Defined in: packages/mcp/src/sessions.ts:131

Close every session

Returns

Promise<void>

---

evictIdle()

evictIdle(): Promise<number>

Defined in: packages/mcp/src/sessions.ts:95

Close and remove sessions idle longer than the timeout

Returns

Promise<number>

number of evicted sessions

---

evictOldest()

evictOldest(allowEvictingAuthenticated?): Promise<string | undefined>

Defined in: packages/mcp/src/sessions.ts:109

Close and remove the least recently used session, preferring anonymous sessions first

Parameters

allowEvictingAuthenticated?

boolean = true

whether an authenticated session may be evicted when no anonymous session exists

Returns

Promise<string | undefined>

the evicted session id, or undefined when there is none

---

get()

get(id): McpSessionEntry | undefined

Defined in: packages/mcp/src/sessions.ts:67

Find a session and refresh its activity

Parameters

id

string

session id

Returns

McpSessionEntry | undefined

the session or undefined

---

remove()

remove(id): void

Defined in: packages/mcp/src/sessions.ts:79

Remove operation

Parameters

id

string

session id to forget (does not close it)

Returns

void