Skip to main content

​
sessions

Global sessions instance that automatically selects the appropriate backend based on environment configuration. 
import { sessions } from '@mcp-ts/sdk/server';
Because sessions is a lazy async proxy, call its methods with await in real code, including generateSessionId().

​
Configuration

# Redis
MCP_TS_STORAGE_TYPE=redis
REDIS_URL=redis://localhost:6379

# File system
MCP_TS_STORAGE_TYPE=file
MCP_TS_STORAGE_FILE=./sessions.json

# In-memory
MCP_TS_STORAGE_TYPE=memory

​
Storage methods

generateSessionId(): Promise<string> 
const sessionId = await sessions.generateSessionId();
create(session: Session): Promise<void> 
await sessions.create({
  sessionId: 'abc123',
  userId: 'user-123',
  serverId: 'server-id',
  serverName: 'My Server',
  serverUrl: 'https://mcp.example.com',
  callbackUrl: 'https://myapp.com/callback',
  transportType: 'streamable-http',
  status: 'active',
  createdAt: Date.now(),
});
update(userId, sessionId, data): Promise<void> 
await sessions.update('user-123', 'abc123', {
  status: 'pending',
});
get(userId, sessionId): Promise<Session | null> 
const session = await sessions.get('user-123', 'abc123');
list(userId): Promise<Session[]> 
const sessionList = await sessions.list('user-123');
listIds(userId): Promise<string[]> 
const sessionIds = await sessions.listIds('user-123');
delete(userId, sessionId): Promise<void> 
await sessions.delete('user-123', 'abc123');
listAllIds(): Promise<string[]> 
const allSessions = await sessions.listAllIds();
clearAll(): Promise<void> 
await sessions.clearAll();
cleanupExpired(): Promise<void> 
await sessions.cleanupExpired();
disconnect(): Promise<void> 
await sessions.disconnect();

​
Direct backends

import {
  RedisStorageBackend,
  MemoryStorageBackend,
  FileStorageBackend,
} from '@mcp-ts/sdk/server';
import Redis from 'ioredis';

const redis = new Redis(process.env.REDIS_URL);
const redisStorage = new RedisStorageBackend(redis);
await redisStorage.init();

const fileStorage = new FileStorageBackend({ path: './sessions.json' });
await fileStorage.init();

const memoryStorage = new MemoryStorageBackend();
await memoryStorage.init();