mcp-use 0.2.0 → 0.3.0

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.2.0",
-  "packageManager": "pnpm@10.6.1",
-  "description": "A utility library for integrating Model Context Protocol (MCP) with LangChain, Zod, and related tools. Provides helpers for schema conversion, event streaming, and SDK usage.",
+  "version": "0.3.0",
+  "description": "Opinionated MCP Framework for TypeScript (@modelcontextprotocol/sdk compatible) - Build MCP Agents and Clients + MCP Servers with support for MCP-UI.",
   "author": "mcp-use, Inc.",
   "license": "MIT",
   "homepage": "https://github.com/mcp-use/mcp-use-ts#readme",
@@ -17,7 +16,6 @@
   "keywords": [
     "MCP",
     "Model Context Protocol",
-    "LangChain",
     "Zod",
     "schema",
     "SDK",
@@ -34,6 +32,14 @@
     "./browser": {
       "types": "./dist/src/browser.d.ts",
       "import": "./dist/src/browser.js"
+    },
+    "./react": {
+      "types": "./dist/src/react/index.d.ts",
+      "import": "./dist/src/react/index.js"
+    },
+    "./server": {
+      "types": "./dist/src/server/index.d.ts",
+      "import": "./dist/src/server/index.js"
     }
   },
   "main": "./dist/index.js",
@@ -46,46 +52,27 @@
     "node": ">=22.0.0"
   },
   "publishConfig": {
-    "registry": "https://registry.npmjs.org"
-  },
-  "scripts": {
-    "build": "rm -rf dist && tsc",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
-    "test": "vitest",
-    "test:run": "vitest run",
-    "test:simple": "vitest run tests/stream_events_simple.test.ts",
-    "test:integration": "vitest run tests/stream_events.test.ts",
-    "watch": "tsc --watch",
-    "start": "node dist/index.js",
-    "prepublishOnly": "npm run build",
-    "fmt": "eslint --fix",
-    "release": "npm version patch --tag-version-prefix=v && git push --follow-tags",
-    "release:minor": "npm version minor --tag-version-prefix=v && git push --follow-tags",
-    "release:major": "npm version major --tag-version-prefix=v && git push --follow-tags",
-    "prepare": "husky",
-    "example:airbnb": "npm run build && node dist/examples/airbnb_use.js",
-    "example:browser": "npm run build && node dist/examples/browser_use.js",
-    "example:chat": "npm run build && node dist/examples/chat_example.js",
-    "example:stream": "npm run build && node dist/examples/stream_example.js",
-    "example:stream_events": "npm run build && node dist/examples/stream_events_example.js",
-    "example:ai_sdk": "npm run build && node dist/examples/ai_sdk_example.js",
-    "example:filesystem": "npm run build && node dist/examples/filesystem_use.js",
-    "example:http": "npm run build && node dist/examples/http_example.js",
-    "example:everything": "npm run build && node dist/examples/mcp_everything.js",
-    "example:multi": "npm run build && node dist/examples/multi_server_example.js",
-    "example:sandbox": "npm run build && node dist/examples/sandbox_everything.js",
-    "example:oauth": "npm run build && node dist/examples/simple_oauth_example.js",
-    "example:blender": "npm run build && node dist/examples/blender_use.js",
-    "example:add_server": "npm run build && node dist/examples/add_server_tool.js",
-    "example:structured": "npm run build && node dist/examples/structured_output.js",
-    "example:observability": "npm run build && node dist/examples/observability.js"
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
   },
   "peerDependencies": {
+    "@mcp-use/inspector": "^0.2.1",
+    "cors": "^2.8.5",
+    "express": "^4.18.2",
     "langfuse": "^3.32.0",
-    "langfuse-langchain": "^3.38.4"
+    "langfuse-langchain": "^3.38.4",
+    "react": "^18.0.0"
   },
   "peerDependenciesMeta": {
+    "@mcp-use/inspector": {
+      "optional": true
+    },
+    "cors": {
+      "optional": true
+    },
+    "express": {
+      "optional": true
+    },
     "langfuse": {
       "optional": true
     },
@@ -98,13 +85,18 @@
     "@langchain/anthropic": "^0.3.26",
     "@langchain/core": "^0.3.72",
     "@langchain/openai": "^0.6.9",
+    "@mcp-ui/server": "^5.11.0",
     "@modelcontextprotocol/sdk": "1.12.1",
     "@scarf/scarf": "^1.4.0",
     "ai": "^4.3.19",
+    "commander": "^14.0.1",
     "dotenv": "^16.5.0",
     "langchain": "^0.3.27",
     "lodash-es": "^4.17.21",
     "posthog-node": "^5.1.1",
+    "strict-url-sanitise": "^0.0.1",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.20.6",
     "uuid": "^11.1.0",
     "winston": "^3.17.0",
     "winston-transport-browserconsole": "^1.0.5",
@@ -114,13 +106,19 @@
   },
   "devDependencies": {
     "@antfu/eslint-config": "^4.13.2",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
     "@types/lodash-es": "^4.17.12",
     "@types/node": "^20.19.8",
+    "@types/react": "^19.2.2",
     "@types/ws": "^8.18.1",
+    "cors": "^2.8.5",
     "eslint": "^9.28.0",
     "eslint-plugin-format": "^1.0.1",
+    "express": "^4.18.2",
     "husky": "^9.1.7",
     "lint-staged": "^15.2.11",
+    "react": "^19.2.0",
     "typescript": "^5.8.3",
     "vitest": "^2.1.9"
   },
@@ -133,5 +131,34 @@
       "eslint --fix",
       "eslint"
     ]
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsup index.ts src/browser.ts src/react/index.ts src/server/index.ts --format cjs,esm --out-dir dist --keep-names && tsc --emitDeclarationOnly --declaration",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:simple": "vitest run tests/stream_events_simple.test.ts",
+    "test:integration": "vitest run tests/stream_events.test.ts",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "fmt": "eslint --fix",
+    "release": "npm version patch --tag-version-prefix=v && git push --follow-tags",
+    "release:minor": "npm version minor --tag-version-prefix=v && git push --follow-tags",
+    "release:major": "npm version major --tag-version-prefix=v && git push --follow-tags",
+    "example:airbnb": "npm run build && node dist/examples/airbnb_use.js",
+    "example:browser": "npm run build && node dist/examples/browser_use.js",
+    "example:chat": "npm run build && node dist/examples/chat_example.js",
+    "example:stream": "npm run build && node dist/examples/stream_example.js",
+    "example:stream_events": "npm run build && node dist/examples/stream_events_example.js",
+    "example:ai_sdk": "npm run build && node dist/examples/ai_sdk_example.js",
+    "example:filesystem": "npm run build && node dist/examples/filesystem_use.js",
+    "example:http": "npm run build && node dist/examples/http_example.js",
+    "example:everything": "npm run build && node dist/examples/mcp_everything.js",
+    "example:multi": "npm run build && node dist/examples/multi_server_example.js",
+    "example:sandbox": "npm run build && node dist/examples/sandbox_everything.js",
+    "example:oauth": "npm run build && node dist/examples/simple_oauth_example.js",
+    "example:blender": "npm run build && node dist/examples/blender_use.js",
+    "example:add_server": "npm run build && node dist/examples/add_server_tool.js",
+    "example:structured": "npm run build && node dist/examples/structured_output.js",
+    "example:observability": "npm run build && node dist/examples/observability.js"
   }
-}
+}

package/dist/src/adapters/base.js

@@ -1,124 +0,0 @@
-import { logger } from '../logging.js';
-/**
- * Abstract base class for converting MCP tools to other framework formats.
- *
- * This class defines the common interface that all adapter implementations
- * should follow to ensure consistency across different frameworks.
- */
-export class BaseAdapter {
-    /**
-     * List of tool names that should not be available.
-     */
-    disallowedTools;
-    /**
-     * Internal cache that maps a connector instance to the list of tools
-     * generated for it.
-     */
-    connectorToolMap = new Map();
-    constructor(disallowedTools) {
-        this.disallowedTools = disallowedTools ?? [];
-    }
-    /**
-     * Create tools from an MCPClient instance.
-     *
-     * This is the recommended way to create tools from an MCPClient, as it handles
-     * session creation and connector extraction automatically.
-     *
-     * @param client          The MCPClient to extract tools from.
-     * @param disallowedTools Optional list of tool names to exclude.
-     * @returns               A promise that resolves with a list of converted tools.
-     */
-    static async createTools(client, disallowedTools) {
-        // Create the adapter
-        const adapter = new this(disallowedTools);
-        // Ensure we have active sessions
-        if (!client.activeSessions || Object.keys(client.activeSessions).length === 0) {
-            logger.info('No active sessions found, creating new ones...');
-            await client.createAllSessions();
-        }
-        // Get all active sessions
-        const sessions = client.getAllActiveSessions();
-        // Extract connectors from sessions
-        const connectors = Object.values(sessions).map(session => session.connector);
-        // Create tools from connectors
-        return adapter.createToolsFromConnectors(connectors);
-    }
-    /**
-     * Dynamically load tools for a specific connector.
-     *
-     * @param connector The connector to load tools for.
-     * @returns         The list of tools that were loaded in the target framework's format.
-     */
-    async loadToolsForConnector(connector) {
-        // Return cached tools if we already processed this connector
-        if (this.connectorToolMap.has(connector)) {
-            const cached = this.connectorToolMap.get(connector);
-            logger.debug(`Returning ${cached.length} existing tools for connector`);
-            return cached;
-        }
-        const connectorTools = [];
-        // Make sure the connector is initialized and has tools
-        const success = await this.ensureConnectorInitialized(connector);
-        if (!success) {
-            return [];
-        }
-        // Convert and collect tools
-        for (const tool of connector.tools) {
-            const converted = this.convertTool(tool, connector);
-            if (converted) {
-                connectorTools.push(converted);
-            }
-        }
-        // Cache the tools for this connector
-        this.connectorToolMap.set(connector, connectorTools);
-        // Log for debugging purposes
-        logger.debug(`Loaded ${connectorTools.length} new tools for connector: ${connectorTools
-            .map((t) => t?.name ?? String(t))
-            .join(', ')}`);
-        return connectorTools;
-    }
-    /**
-     * Create tools from MCP tools in all provided connectors.
-     *
-     * @param connectors List of MCP connectors to create tools from.
-     * @returns         A promise that resolves with all converted tools.
-     */
-    async createToolsFromConnectors(connectors) {
-        const tools = [];
-        for (const connector of connectors) {
-            const connectorTools = await this.loadToolsForConnector(connector);
-            tools.push(...connectorTools);
-        }
-        logger.debug(`Available tools: ${tools.length}`);
-        return tools;
-    }
-    /**
-     * Check if a connector is initialized and has tools.
-     *
-     * @param connector The connector to check.
-     * @returns         True if the connector is initialized and has tools, false otherwise.
-     */
-    checkConnectorInitialized(connector) {
-        return Boolean(connector.tools && connector.tools.length);
-    }
-    /**
-     * Ensure a connector is initialized.
-     *
-     * @param connector The connector to initialize.
-     * @returns         True if initialization succeeded, false otherwise.
-     */
-    async ensureConnectorInitialized(connector) {
-        if (!this.checkConnectorInitialized(connector)) {
-            logger.debug('Connector doesn\'t have tools, initializing it');
-            try {
-                await connector.initialize();
-                return true;
-            }
-            catch (err) {
-                logger.error(`Error initializing connector: ${err}`);
-                return false;
-            }
-        }
-        return true;
-    }
-}

package/dist/src/adapters/index.js

@@ -1,2 +0,0 @@
-export { BaseAdapter } from './base.js';
-export { LangChainAdapter } from './langchain_adapter.js';

package/dist/src/adapters/langchain_adapter.js

@@ -1,49 +0,0 @@
-import { JSONSchemaToZod } from '@dmitryrechkin/json-schema-to-zod';
-import { DynamicStructuredTool } from '@langchain/core/tools';
-import { z } from 'zod';
-import { logger } from '../logging.js';
-import { BaseAdapter } from './base.js';
-function schemaToZod(schema) {
-    try {
-        return JSONSchemaToZod.convert(schema);
-    }
-    catch (err) {
-        logger.warn(`Failed to convert JSON schema to Zod: ${err}`);
-        return z.any();
-    }
-}
-export class LangChainAdapter extends BaseAdapter {
-    constructor(disallowedTools = []) {
-        super(disallowedTools);
-    }
-    /**
-     * Convert a single MCP tool specification into a LangChainJS structured tool.
-     */
-    convertTool(mcpTool, connector) {
-        // Filter out disallowed tools early.
-        if (this.disallowedTools.includes(mcpTool.name)) {
-            return null;
-        }
-        // Derive a strict Zod schema for the tool's arguments.
-        const argsSchema = mcpTool.inputSchema
-            ? schemaToZod(mcpTool.inputSchema)
-            : z.object({}).optional();
-        const tool = new DynamicStructuredTool({
-            name: mcpTool.name ?? 'NO NAME',
-            description: mcpTool.description ?? '', // Blank is acceptable but discouraged.
-            schema: argsSchema,
-            func: async (input) => {
-                logger.debug(`MCP tool \"${mcpTool.name}\" received input: ${JSON.stringify(input)}`);
-                try {
-                    const result = await connector.callTool(mcpTool.name, input);
-                    return JSON.stringify(result);
-                }
-                catch (err) {
-                    logger.error(`Error executing MCP tool: ${err.message}`);
-                    return `Error executing MCP tool: ${String(err)}`;
-                }
-            },
-        });
-        return tool;
-    }
-}

package/dist/src/agents/base.js

@@ -1,9 +0,0 @@
-export class BaseAgent {
-    session;
-    /**
-     * @param session MCP session used for tool invocation
-     */
-    constructor(session) {
-        this.session = session;
-    }
-}

package/dist/src/agents/index.js

@@ -1,3 +0,0 @@
-export { BaseAgent } from './base.js';
-export { MCPAgent } from './mcp_agent.js';
-export { RemoteAgent } from './remote.js';