@mcp-ts/sdk 1.0.0

package/dist/types-SbDlA2VX.d.ts

@@ -0,0 +1,153 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+
+/**
+ * Type definitions for MCP operations
+ */
+
+interface ConnectRequest {
+    serverUrl: string;
+    callbackUrl: string;
+}
+interface ConnectSuccessResponse {
+    success: true;
+    sessionId: string;
+}
+interface ConnectAuthRequiredResponse {
+    requiresAuth: true;
+    authUrl: string;
+    sessionId: string;
+}
+interface ConnectErrorResponse {
+    error: string;
+}
+type ConnectResponse = ConnectSuccessResponse | ConnectAuthRequiredResponse | ConnectErrorResponse;
+interface ListToolsSuccessResponse {
+    tools: Tool[];
+}
+interface ListToolsErrorResponse {
+    error: string;
+}
+type ListToolsResponse = ListToolsSuccessResponse | ListToolsErrorResponse;
+interface CallToolRequest {
+    sessionId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+interface CallToolSuccessResponse {
+    content: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError: boolean;
+}
+interface CallToolErrorResponse {
+    error: string;
+}
+type CallToolResponse = CallToolSuccessResponse | CallToolErrorResponse;
+declare function isConnectSuccess(response: ConnectResponse): response is ConnectSuccessResponse;
+declare function isConnectAuthRequired(response: ConnectResponse): response is ConnectAuthRequiredResponse;
+declare function isConnectError(response: ConnectResponse): response is ConnectErrorResponse;
+declare function isListToolsSuccess(response: ListToolsResponse): response is ListToolsSuccessResponse;
+declare function isCallToolSuccess(response: CallToolResponse): response is CallToolSuccessResponse;
+type ToolInfo = {
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+};
+type TransportType = 'sse' | 'streamable_http';
+type McpRpcMethod = 'connect' | 'disconnect' | 'listTools' | 'callTool' | 'getSessions' | 'restoreSession' | 'finishAuth' | 'listPrompts' | 'getPrompt' | 'listResources' | 'readResource';
+interface McpRpcRequest {
+    id: string;
+    method: McpRpcMethod;
+    params?: McpRpcParams;
+}
+interface McpRpcResponse<T = unknown> {
+    id: string;
+    result?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+interface ConnectParams {
+    serverId: string;
+    serverName: string;
+    serverUrl: string;
+    callbackUrl: string;
+    transportType?: TransportType;
+}
+interface DisconnectParams {
+    sessionId: string;
+}
+interface SessionParams {
+    sessionId: string;
+}
+interface CallToolParams {
+    sessionId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+}
+interface GetPromptParams {
+    sessionId: string;
+    name: string;
+    args?: Record<string, string>;
+}
+interface ReadResourceParams {
+    sessionId: string;
+    uri: string;
+}
+interface FinishAuthParams {
+    sessionId: string;
+    code: string;
+}
+type McpRpcParams = ConnectParams | DisconnectParams | SessionParams | CallToolParams | GetPromptParams | ReadResourceParams | FinishAuthParams | undefined;
+interface SessionInfo {
+    sessionId: string;
+    serverId?: string;
+    serverName?: string;
+    serverUrl: string;
+    transport: TransportType;
+}
+interface SessionListResult {
+    sessions: SessionInfo[];
+}
+interface ConnectResult {
+    sessionId: string;
+    success: boolean;
+}
+interface DisconnectResult {
+    success: boolean;
+}
+interface RestoreSessionResult {
+    success: boolean;
+    toolCount: number;
+}
+interface FinishAuthResult {
+    success: boolean;
+    toolCount: number;
+}
+interface ListToolsRpcResult {
+    tools: Tool[];
+}
+interface ListPromptsResult {
+    prompts: Array<{
+        name: string;
+        description?: string;
+        arguments?: Array<{
+            name: string;
+            description?: string;
+            required?: boolean;
+        }>;
+    }>;
+}
+interface ListResourcesResult {
+    resources: Array<{
+        uri: string;
+        name: string;
+        description?: string;
+        mimeType?: string;
+    }>;
+}
+
+export { type CallToolParams as C, type DisconnectParams as D, type FinishAuthParams as F, type GetPromptParams as G, type ListPromptsResult as L, type McpRpcMethod as M, type ReadResourceParams as R, type SessionInfo as S, type ToolInfo as T, type CallToolRequest as a, type CallToolResponse as b, type ConnectAuthRequiredResponse as c, type ConnectErrorResponse as d, type ConnectParams as e, type ConnectRequest as f, type ConnectResponse as g, type ConnectResult as h, type ConnectSuccessResponse as i, type DisconnectResult as j, type FinishAuthResult as k, type ListResourcesResult as l, type ListToolsResponse as m, type ListToolsRpcResult as n, type McpRpcParams as o, type McpRpcRequest as p, type McpRpcResponse as q, type RestoreSessionResult as r, type SessionListResult as s, type SessionParams as t, type TransportType as u, isCallToolSuccess as v, isConnectAuthRequired as w, isConnectError as x, isConnectSuccess as y, isListToolsSuccess as z };

package/dist/utils-0qmYrqoa.d.mts

@@ -0,0 +1,92 @@
+/**
+ * Standardized error classes for MCP Redis library
+ * Provides consistent error handling across the codebase
+ */
+/**
+ * Base error class for all MCP-related errors
+ */
+declare class McpError extends Error {
+    readonly code: string;
+    readonly cause?: Error | undefined;
+    constructor(code: string, message: string, cause?: Error | undefined);
+    toJSON(): {
+        cause?: string | undefined;
+        name: string;
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Thrown when OAuth authorization is required
+ */
+declare class UnauthorizedError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when connection to MCP server fails
+ */
+declare class ConnectionError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when session is not found or expired
+ */
+declare class SessionNotFoundError extends McpError {
+    constructor(sessionId: string, cause?: Error);
+}
+/**
+ * Thrown when session validation fails
+ */
+declare class SessionValidationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when authentication fails
+ */
+declare class AuthenticationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when OAuth state validation fails
+ */
+declare class InvalidStateError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when client is not connected
+ */
+declare class NotConnectedError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when required configuration is missing
+ */
+declare class ConfigurationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when tool execution fails
+ */
+declare class ToolExecutionError extends McpError {
+    constructor(toolName: string, message: string, cause?: Error);
+}
+/**
+ * RPC error codes for SSE communication
+ */
+declare const RpcErrorCodes: {
+    readonly EXECUTION_ERROR: "EXECUTION_ERROR";
+    readonly MISSING_IDENTITY: "MISSING_IDENTITY";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly NO_CONNECTION: "NO_CONNECTION";
+    readonly UNKNOWN_METHOD: "UNKNOWN_METHOD";
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+};
+type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];
+
+/**
+ * Sanitize server name to create a valid server label
+ * Must start with a letter and contain only letters, digits, '-' and '_'
+ */
+declare function sanitizeServerLabel(name: string): string;
+
+export { AuthenticationError as A, ConfigurationError as C, InvalidStateError as I, McpError as M, NotConnectedError as N, type RpcErrorCode as R, SessionNotFoundError as S, ToolExecutionError as T, UnauthorizedError as U, ConnectionError as a, RpcErrorCodes as b, SessionValidationError as c, sanitizeServerLabel as s };

package/dist/utils-0qmYrqoa.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Standardized error classes for MCP Redis library
+ * Provides consistent error handling across the codebase
+ */
+/**
+ * Base error class for all MCP-related errors
+ */
+declare class McpError extends Error {
+    readonly code: string;
+    readonly cause?: Error | undefined;
+    constructor(code: string, message: string, cause?: Error | undefined);
+    toJSON(): {
+        cause?: string | undefined;
+        name: string;
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Thrown when OAuth authorization is required
+ */
+declare class UnauthorizedError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when connection to MCP server fails
+ */
+declare class ConnectionError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when session is not found or expired
+ */
+declare class SessionNotFoundError extends McpError {
+    constructor(sessionId: string, cause?: Error);
+}
+/**
+ * Thrown when session validation fails
+ */
+declare class SessionValidationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when authentication fails
+ */
+declare class AuthenticationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when OAuth state validation fails
+ */
+declare class InvalidStateError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when client is not connected
+ */
+declare class NotConnectedError extends McpError {
+    constructor(message?: string, cause?: Error);
+}
+/**
+ * Thrown when required configuration is missing
+ */
+declare class ConfigurationError extends McpError {
+    constructor(message: string, cause?: Error);
+}
+/**
+ * Thrown when tool execution fails
+ */
+declare class ToolExecutionError extends McpError {
+    constructor(toolName: string, message: string, cause?: Error);
+}
+/**
+ * RPC error codes for SSE communication
+ */
+declare const RpcErrorCodes: {
+    readonly EXECUTION_ERROR: "EXECUTION_ERROR";
+    readonly MISSING_IDENTITY: "MISSING_IDENTITY";
+    readonly UNAUTHORIZED: "UNAUTHORIZED";
+    readonly NO_CONNECTION: "NO_CONNECTION";
+    readonly UNKNOWN_METHOD: "UNKNOWN_METHOD";
+    readonly INVALID_PARAMS: "INVALID_PARAMS";
+};
+type RpcErrorCode = typeof RpcErrorCodes[keyof typeof RpcErrorCodes];
+
+/**
+ * Sanitize server name to create a valid server label
+ * Must start with a letter and contain only letters, digits, '-' and '_'
+ */
+declare function sanitizeServerLabel(name: string): string;
+
+export { AuthenticationError as A, ConfigurationError as C, InvalidStateError as I, McpError as M, NotConnectedError as N, type RpcErrorCode as R, SessionNotFoundError as S, ToolExecutionError as T, UnauthorizedError as U, ConnectionError as a, RpcErrorCodes as b, SessionValidationError as c, sanitizeServerLabel as s };

package/package.json

@@ -0,0 +1,165 @@
+{
+  "name": "@mcp-ts/sdk",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "A Lightweight MCP (Model Context Protocol) client library for JavaScript applications, supporting multiple storage backends (Memory, File, Redis) and real-time SSE support.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.mjs",
+      "require": "./dist/client/index.js"
+    },
+    "./client/react": {
+      "types": "./dist/client/react.d.ts",
+      "import": "./dist/client/react.mjs",
+      "require": "./dist/client/react.js"
+    },
+    "./client/vue": {
+      "types": "./dist/client/vue.d.ts",
+      "import": "./dist/client/vue.mjs",
+      "require": "./dist/client/vue.js"
+    },
+    "./shared": {
+      "types": "./dist/shared/index.d.ts",
+      "import": "./dist/shared/index.mjs",
+      "require": "./dist/shared/index.js"
+    },
+    "./adapters/ai": {
+      "types": "./dist/adapters/ai-adapter.d.ts",
+      "import": "./dist/adapters/ai-adapter.mjs",
+      "require": "./dist/adapters/ai-adapter.js"
+    },
+    "./adapters/langchain": {
+      "types": "./dist/adapters/langchain-adapter.d.ts",
+      "import": "./dist/adapters/langchain-adapter.mjs",
+      "require": "./dist/adapters/langchain-adapter.js"
+    },
+    "./adapters/mastra": {
+      "types": "./dist/adapters/mastra-adapter.d.ts",
+      "import": "./dist/adapters/mastra-adapter.mjs",
+      "require": "./dist/adapters/mastra-adapter.js"
+    },
+    "./adapters/agui-adapter": {
+      "types": "./dist/adapters/agui-adapter.d.ts",
+      "import": "./dist/adapters/agui-adapter.mjs",
+      "require": "./dist/adapters/agui-adapter.js"
+    },
+    "./adapters/agui-middleware": {
+      "types": "./dist/adapters/agui-middleware.d.ts",
+      "import": "./dist/adapters/agui-middleware.mjs",
+      "require": "./dist/adapters/agui-middleware.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "test": "npx playwright test",
+    "test:ui": "npx playwright test --ui",
+    "test:debug": "npx playwright test --debug"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "oauth",
+    "redis",
+    "sse",
+    "server-sent-events",
+    "serverless",
+    "react",
+    "hook",
+    "anthropic",
+    "claude"
+  ],
+  "author": "MCP Assistant Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zonlabs/mcp-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zonlabs/mcp-ts/issues"
+  },
+  "homepage": "https://github.com/zonlabs/mcp-ts#readme",
+  "peerDependencies": {
+    "@ag-ui/client": ">=0.0.40",
+    "@langchain/core": "^0.3.0",
+    "ai": "^6.0.0",
+    "ioredis": "^5.0.0",
+    "react": ">=18.0.0",
+    "rxjs": ">=7.0.0",
+    "zod": "^3.23.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "ai": {
+      "optional": true
+    },
+    "@ag-ui/client": {
+      "optional": true
+    },
+    "rxjs": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.3",
+    "json-schema": "^0.4.0",
+    "json-schema-to-zod": "^2.7.0",
+    "nanoid": "^5.1.6"
+  },
+  "devDependencies": {
+    "@ag-ui/client": "^0.0.42",
+    "@langchain/core": "^0.3.33",
+    "@playwright/test": "^1.58.0",
+    "@types/json-schema": "^7.0.15",
+    "@types/node": "^25.0.10",
+    "@types/react": "^18.3.18",
+    "ai": "^6.0.49",
+    "ioredis": "^5.9.2",
+    "ioredis-mock": "^8.13.1",
+    "playwright": "^1.58.0",
+    "react": "^18.3.1",
+    "rimraf": "^6.1.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vue": "^3.5.27",
+    "zod": "^3.24.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}