mcp-use 0.0.8 → 0.1.0

package/README.md

@@ -126,6 +126,38 @@ const client = MCPClient.fromConfigFile('./mcp-config.json')
 
 ---
 
+## 📚 Examples
+
+We provide a comprehensive set of examples demonstrating various use cases. All examples are located in the `examples/` directory with a dedicated README.
+
+### Running Examples
+
+```bash
+# Install dependencies
+npm install
+
+# Run any example
+npm run example:airbnb      # Search accommodations with Airbnb
+npm run example:browser     # Browser automation with Playwright
+npm run example:chat        # Interactive chat with memory
+npm run example:filesystem  # File system operations
+npm run example:http        # HTTP server connection
+npm run example:everything  # Test MCP functionalities
+npm run example:multi       # Multiple servers in one session
+```
+
+### Example Highlights
+
+- **Browser Automation**: Control browsers to navigate websites and extract information
+- **File Operations**: Read, write, and manipulate files through MCP
+- **Multi-Server**: Combine multiple MCP servers (Airbnb + Browser) in a single task
+- **Sandboxed Execution**: Run MCP servers in isolated E2B containers
+- **OAuth Flows**: Authenticate with services like Linear using OAuth2
+
+See the [examples README](./examples/README.md) for detailed documentation and prerequisites.
+
+---
+
 ## 🔄 Multi-Server Example
 
 ```ts

package/dist/examples/add_server_tool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Dynamic server management example for mcp-use.
+ *
+ * This example demonstrates how to equip an MCPAgent with a tool
+ * to dynamically add and connect to MCP servers during a run.
+ */
+export {};
+//# sourceMappingURL=add_server_tool.d.ts.map

package/dist/examples/add_server_tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add_server_tool.d.ts","sourceRoot":"","sources":["../../examples/add_server_tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/examples/add_server_tool.js

@@ -0,0 +1,65 @@
+/**
+ * Dynamic server management example for mcp-use.
+ *
+ * This example demonstrates how to equip an MCPAgent with a tool
+ * to dynamically add and connect to MCP servers during a run.
+ */
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+import { LangChainAdapter } from '../src/adapters/langchain_adapter.js';
+import { ServerManager } from '../src/managers/server_manager.js';
+// Load environment variables from .env file
+config();
+async function main() {
+    // Create an empty MCPClient. It has no servers to start with.
+    const client = new MCPClient();
+    // The LLM to power the agent
+    const llm = new ChatOpenAI({ model: 'gpt-4o', temperature: 0 });
+    // Create the agent, enabling the ServerManager
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 30,
+        useServerManager: true,
+        serverManagerFactory: client => new ServerManager(client, new LangChainAdapter()),
+        autoInitialize: true,
+    });
+    // Define the server configuration that the agent will be asked to add.
+    const serverConfigA = {
+        command: 'npx',
+        args: ['@playwright/mcp@latest'],
+        env: {
+            DISPLAY: ':1',
+        },
+    };
+    const serverConfigB = {
+        command: 'npx',
+        args: ['-y', '@openbnb/mcp-server-airbnb', '--ignore-robots-txt'],
+    };
+    // We'll pass the config as a JSON string in the prompt.
+    const serverConfigStringA = JSON.stringify(serverConfigA, null, 2);
+    const serverConfigStringB = JSON.stringify(serverConfigB, null, 2);
+    const query = `I need to browse the web. To do this, please add and connect to a new MCP server for Playwright.
+    The server name is 'playwright' and its configuration is:
+    \`\`\`json
+    ${serverConfigStringA}
+    \`\`\`
+    Once the server is ready, navigate to https://github.com/mcp-use/mcp-use, give a star to the project, and then provide a concise summary of the project's README.
+
+    Then, please add and connect to a new MCP server for Airbnb.
+    The server name is 'airbnb' and its configuration is:
+    \`\`\`json
+    ${serverConfigStringB}
+    \`\`\`
+    and give me a house in the location of the company mcp-use.
+    `;
+    // Run the agent. It will first use the AddMCPServerTool, then the tools from the new server.
+    const result = await agent.run(query);
+    console.log(`\n✅ Final Result:\n${result}`);
+    // Clean up the session created by the agent
+    await client.closeAllSessions();
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}

package/dist/examples/airbnb_use.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Example demonstrating how to use mcp-use with Airbnb.
+ *
+ * This example shows how to connect an LLM to Airbnb through MCP tools
+ * to perform tasks like searching for accommodations.
+ *
+ * Special Thanks to https://github.com/openbnb-org/mcp-server-airbnb for the server.
+ */
+export {};
+//# sourceMappingURL=airbnb_use.d.ts.map

package/dist/examples/airbnb_use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airbnb_use.d.ts","sourceRoot":"","sources":["../../examples/airbnb_use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/examples/airbnb_use.js

@@ -0,0 +1,43 @@
+/**
+ * Example demonstrating how to use mcp-use with Airbnb.
+ *
+ * This example shows how to connect an LLM to Airbnb through MCP tools
+ * to perform tasks like searching for accommodations.
+ *
+ * Special Thanks to https://github.com/openbnb-org/mcp-server-airbnb for the server.
+ */
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+async function runAirbnbExample() {
+    // Create MCPClient with Airbnb configuration
+    const config = {
+        mcpServers: {
+            airbnb: {
+                command: 'npx',
+                args: ['-y', '@openbnb/mcp-server-airbnb', '--ignore-robots-txt'],
+            },
+        },
+    };
+    const client = new MCPClient(config);
+    // Create LLM - you can choose between different models
+    const llm = new ChatOpenAI({ model: 'gpt-4o' });
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    try {
+        // Run a query to search for accommodations
+        const result = await agent.run('Find me a nice place to stay in Barcelona for 2 adults '
+            + 'for a week in August. I prefer places with a pool and '
+            + 'good reviews. Show me the top 3 options.', 30);
+        console.error(`\nResult: ${result}`);
+    }
+    finally {
+        // Ensure we clean up resources properly
+        await client.closeAllSessions();
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runAirbnbExample().catch(console.error);
+}

package/dist/examples/blender_use.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Blender MCP example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect an LLM to Blender through MCP tools via WebSocket.
+ * The example assumes you have installed the Blender MCP addon from:
+ * https://github.com/ahujasid/blender-mcp
+ *
+ * Make sure the addon is enabled in Blender preferences and the WebSocket
+ * server is running before executing this script.
+ *
+ * Special thanks to https://github.com/ahujasid/blender-mcp for the server.
+ */
+export {};
+//# sourceMappingURL=blender_use.d.ts.map

package/dist/examples/blender_use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blender_use.d.ts","sourceRoot":"","sources":["../../examples/blender_use.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/examples/blender_use.js

@@ -0,0 +1,39 @@
+/**
+ * Blender MCP example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect an LLM to Blender through MCP tools via WebSocket.
+ * The example assumes you have installed the Blender MCP addon from:
+ * https://github.com/ahujasid/blender-mcp
+ *
+ * Make sure the addon is enabled in Blender preferences and the WebSocket
+ * server is running before executing this script.
+ *
+ * Special thanks to https://github.com/ahujasid/blender-mcp for the server.
+ */
+import { ChatAnthropic } from '@langchain/anthropic';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+async function runBlenderExample() {
+    // Create MCPClient with Blender MCP configuration
+    const config = { mcpServers: { blender: { command: 'uvx', args: ['blender-mcp'] } } };
+    const client = MCPClient.fromDict(config);
+    // Create LLM
+    const llm = new ChatAnthropic({ model: 'claude-3-5-sonnet-20240620' });
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    try {
+        // Run the query
+        const result = await agent.run('Create an inflatable cube with soft material and a plane as ground.', 30);
+        console.error(`\nResult: ${result}`);
+    }
+    finally {
+        // Ensure we clean up resources properly
+        await client.closeAllSessions();
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runBlenderExample().catch(console.error);
+}

package/dist/examples/browser_use.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Basic usage example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect any LLM to MCP tools through a unified interface.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+export {};
+//# sourceMappingURL=browser_use.d.ts.map

package/dist/examples/browser_use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser_use.d.ts","sourceRoot":"","sources":["../../examples/browser_use.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/examples/browser_use.js

@@ -0,0 +1,46 @@
+/**
+ * Basic usage example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect any LLM to MCP tools through a unified interface.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function main() {
+    const config = {
+        mcpServers: {
+            playwright: {
+                command: 'npx',
+                args: ['@playwright/mcp@latest'],
+                env: {
+                    DISPLAY: ':1',
+                },
+            },
+        },
+    };
+    // Create MCPClient from config file
+    const client = new MCPClient(config);
+    // Create LLM
+    const llm = new ChatOpenAI({ model: 'gpt-4o' });
+    // const llm = init_chat_model({ model: "llama-3.1-8b-instant", model_provider: "groq" })
+    // const llm = new ChatAnthropic({ model: "claude-3-" })
+    // const llm = new ChatGroq({ model: "llama3-8b-8192" })
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    // Run the query
+    const result = await agent.run(`Navigate to https://github.com/mcp-use/mcp-use, give a star to the project and write
+a summary of the project.`, 30);
+    console.error(`\nResult: ${result}`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}

package/dist/examples/chat_example.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Simple chat example using MCPAgent with built-in conversation memory.
+ *
+ * This example demonstrates how to use the MCPAgent with its built-in
+ * conversation history capabilities for better contextual interactions.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+export {};
+//# sourceMappingURL=chat_example.d.ts.map

package/dist/examples/chat_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat_example.d.ts","sourceRoot":"","sources":["../../examples/chat_example.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/examples/chat_example.js

@@ -0,0 +1,86 @@
+/**
+ * Simple chat example using MCPAgent with built-in conversation memory.
+ *
+ * This example demonstrates how to use the MCPAgent with its built-in
+ * conversation history capabilities for better contextual interactions.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+import readline from 'node:readline';
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+async function runMemoryChat() {
+    // Config file path - change this to your config file
+    const config = {
+        mcpServers: {
+            airbnb: {
+                command: 'npx',
+                args: ['-y', '@openbnb/mcp-server-airbnb', '--ignore-robots-txt'],
+            },
+        },
+    };
+    console.error('Initializing chat...');
+    // Create MCP client and agent with memory enabled
+    const client = new MCPClient(config);
+    const llm = new ChatOpenAI({ model: 'gpt-4o-mini' });
+    // Create agent with memory_enabled=true
+    const agent = new MCPAgent({
+        llm,
+        client,
+        maxSteps: 15,
+        memoryEnabled: true, // Enable built-in conversation memory
+    });
+    console.error('\n===== Interactive MCP Chat =====');
+    console.error('Type \'exit\' or \'quit\' to end the conversation');
+    console.error('Type \'clear\' to clear conversation history');
+    console.error('==================================\n');
+    // Create readline interface for user input
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (prompt) => {
+        return new Promise((resolve) => {
+            rl.question(prompt, resolve);
+        });
+    };
+    try {
+        // Main chat loop
+        while (true) {
+            // Get user input
+            const userInput = await question('\nYou: ');
+            // Check for exit command
+            if (userInput.toLowerCase() === 'exit' || userInput.toLowerCase() === 'quit') {
+                console.error('Ending conversation...');
+                break;
+            }
+            // Check for clear history command
+            if (userInput.toLowerCase() === 'clear') {
+                agent.clearConversationHistory();
+                console.error('Conversation history cleared.');
+                continue;
+            }
+            // Get response from agent
+            process.stdout.write('\nAssistant: ');
+            try {
+                // Run the agent with the user input (memory handling is automatic)
+                const response = await agent.run(userInput);
+                console.error(response);
+            }
+            catch (error) {
+                console.error(`\nError: ${error}`);
+            }
+        }
+    }
+    finally {
+        // Clean up
+        rl.close();
+        await client.closeAllSessions();
+    }
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runMemoryChat().catch(console.error);
+}

package/dist/examples/filesystem_use.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Basic usage example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect any LLM to MCP tools through a unified interface.
+ *
+ * Special Thanks to https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
+ * for the server.
+ */
+export {};
+//# sourceMappingURL=filesystem_use.d.ts.map

package/dist/examples/filesystem_use.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem_use.d.ts","sourceRoot":"","sources":["../../examples/filesystem_use.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/examples/filesystem_use.js

@@ -0,0 +1,43 @@
+/**
+ * Basic usage example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect any LLM to MCP tools through a unified interface.
+ *
+ * Special Thanks to https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem
+ * for the server.
+ */
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+const serverConfig = {
+    mcpServers: {
+        filesystem: {
+            command: 'npx',
+            args: [
+                '-y',
+                '@modelcontextprotocol/server-filesystem',
+                'THE_PATH_TO_YOUR_DIRECTORY',
+            ],
+        },
+    },
+};
+async function main() {
+    // Create MCPClient from config
+    const client = MCPClient.fromDict(serverConfig);
+    // Create LLM
+    const llm = new ChatOpenAI({ model: 'gpt-4o' });
+    // const llm = init_chat_model({ model: "llama-3.1-8b-instant", model_provider: "groq" })
+    // const llm = new ChatAnthropic({ model: "claude-3-" })
+    // const llm = new ChatGroq({ model: "llama3-8b-8192" })
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    // Run the query
+    const result = await agent.run('Hello can you give me a list of files and directories in the current directory', 30);
+    console.log(`\nResult: ${result}`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}

package/dist/examples/http_example.d.ts

@@ -0,0 +1,18 @@
+/**
+ * HTTP Example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect to an MCP server running on a specific HTTP port.
+ *
+ * Before running this example, you need to start the Playwright MCP server
+ * in another terminal with:
+ *
+ *     npx @playwright/mcp@latest --port 8931
+ *
+ * This will start the server on port 8931. Resulting in the config you find below.
+ * Of course you can run this with any server you want at any URL.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+export {};
+//# sourceMappingURL=http_example.d.ts.map

package/dist/examples/http_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http_example.d.ts","sourceRoot":"","sources":["../../examples/http_example.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/examples/http_example.js

@@ -0,0 +1,36 @@
+/**
+ * HTTP Example for mcp-use.
+ *
+ * This example demonstrates how to use the mcp-use library with MCPClient
+ * to connect to an MCP server running on a specific HTTP port.
+ *
+ * Before running this example, you need to start the Playwright MCP server
+ * in another terminal with:
+ *
+ *     npx @playwright/mcp@latest --port 8931
+ *
+ * This will start the server on port 8931. Resulting in the config you find below.
+ * Of course you can run this with any server you want at any URL.
+ *
+ * Special thanks to https://github.com/microsoft/playwright-mcp for the server.
+ */
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+async function main() {
+    const config = { mcpServers: { http: { url: 'https://hf.com/mcp' } } };
+    // Create MCPClient from config
+    const client = MCPClient.fromDict(config);
+    // Create LLM
+    const llm = new ChatOpenAI({ model: 'gpt-4o' });
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    // Run the query
+    const result = await agent.run('Find the best restaurant in San Francisco USING GOOGLE SEARCH', 30);
+    console.log(`\nResult: ${result}`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}

package/dist/examples/mcp_everything.d.ts

@@ -0,0 +1,6 @@
+/**
+ * This example shows how to test the different functionalities of MCPs using the MCP server from
+ * anthropic.
+ */
+export {};
+//# sourceMappingURL=mcp_everything.d.ts.map

package/dist/examples/mcp_everything.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp_everything.d.ts","sourceRoot":"","sources":["../../examples/mcp_everything.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/examples/mcp_everything.js

@@ -0,0 +1,25 @@
+/**
+ * This example shows how to test the different functionalities of MCPs using the MCP server from
+ * anthropic.
+ */
+import { ChatOpenAI } from '@langchain/openai';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+const everythingServer = {
+    mcpServers: { everything: { command: 'npx', args: ['-y', '@modelcontextprotocol/server-everything'] } },
+};
+async function main() {
+    const client = new MCPClient(everythingServer);
+    const llm = new ChatOpenAI({ model: 'gpt-4o', temperature: 0 });
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    const result = await agent.run(`Hello, you are a tester can you please answer the follwing questions:
+- Which resources do you have access to?
+- Which prompts do you have access to?
+- Which tools do you have access to?`, 30);
+    console.log(`\nResult: ${result}`);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().catch(console.error);
+}

package/dist/examples/multi_server_example.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Example demonstrating how to use MCPClient with multiple servers.
+ *
+ * This example shows how to:
+ * 1. Configure multiple MCP servers
+ * 2. Create and manage sessions for each server
+ * 3. Use tools from different servers in a single agent
+ */
+export {};
+//# sourceMappingURL=multi_server_example.d.ts.map

package/dist/examples/multi_server_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi_server_example.d.ts","sourceRoot":"","sources":["../../examples/multi_server_example.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/examples/multi_server_example.js

@@ -0,0 +1,51 @@
+/**
+ * Example demonstrating how to use MCPClient with multiple servers.
+ *
+ * This example shows how to:
+ * 1. Configure multiple MCP servers
+ * 2. Create and manage sessions for each server
+ * 3. Use tools from different servers in a single agent
+ */
+import { ChatAnthropic } from '@langchain/anthropic';
+import { config } from 'dotenv';
+import { MCPAgent, MCPClient } from '../index.js';
+// Load environment variables from .env file
+config();
+async function runMultiServerExample() {
+    // Create a configuration with multiple servers
+    const config = {
+        mcpServers: {
+            airbnb: {
+                command: 'npx',
+                args: ['-y', '@openbnb/mcp-server-airbnb', '--ignore-robots-txt'],
+            },
+            playwright: {
+                command: 'npx',
+                args: ['@playwright/mcp@latest'],
+                env: { DISPLAY: ':1' },
+            },
+            filesystem: {
+                command: 'npx',
+                args: [
+                    '-y',
+                    '@modelcontextprotocol/server-filesystem',
+                    'YOUR_DIRECTORY_HERE',
+                ],
+            },
+        },
+    };
+    // Create MCPClient with the multi-server configuration
+    const client = MCPClient.fromDict(config);
+    // Create LLM
+    const llm = new ChatAnthropic({ model: 'claude-3-5-sonnet-20240620' });
+    // Create agent with the client
+    const agent = new MCPAgent({ llm, client, maxSteps: 30 });
+    // Example 1: Using tools from different servers in a single query
+    const result = await agent.run('Search for a nice place to stay in Barcelona on Airbnb, '
+        + 'then use Google to find nearby restaurants and attractions.'
+        + 'Write the result in the current directory in restarant.txt', 30);
+    console.log(result);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runMultiServerExample().catch(console.error);
+}

package/dist/src/connectors/stdio.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/connectors/stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;gBAG5D,EACE,OAAe,EACf,IAAS,EACT,GAAG,EACH,MAAuB,EACvB,GAAG,IAAI,EACR,GAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,QAAQ,CAAA;KAClB,GAAG,qBAA0B;IAWhC,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAiC/B"}
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../../src/connectors/stdio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAMrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/C;AAED,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAwB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmC;gBAG5D,EACE,OAAe,EACf,IAAS,EACT,GAAG,EACH,MAAuB,EACvB,GAAG,IAAI,EACR,GAAE;QACD,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;QAC5B,MAAM,CAAC,EAAE,QAAQ,CAAA;KAClB,GAAG,qBAA0B;IAWhC,sDAAsD;IAChD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CA+C/B"}

package/dist/src/connectors/stdio.js

@@ -26,10 +26,23 @@ export class StdioConnector extends BaseConnector {
         logger.debug(`Connecting to MCP implementation via stdio: ${this.command}`);
         try {
             // 1. Build server parameters for the transport
+            // Merge env with process.env, filtering out undefined values
+            let mergedEnv;
+            if (this.env) {
+                mergedEnv = {};
+                // First add process.env values (excluding undefined)
+                for (const [key, value] of Object.entries(process.env)) {
+                    if (value !== undefined) {
+                        mergedEnv[key] = value;
+                    }
+                }
+                // Then override with provided env
+                Object.assign(mergedEnv, this.env);
+            }
             const serverParams = {
                 command: this.command,
                 args: this.args,
-                env: this.env,
+                env: mergedEnv,
             };
             // 2. Start the connection manager -> returns a live transport
             this.connectionManager = new StdioConnectionManager(serverParams, this.errlog);

package/dist/src/managers/server_manager.d.ts

@@ -8,6 +8,7 @@ export declare class ServerManager {
     readonly adapter: LangChainAdapter;
     activeServer: string | null;
     constructor(client: MCPClient, adapter: LangChainAdapter);
+    logState(context: string): void;
     initialize(): void;
     prefetchServerTools(): Promise<void>;
     get tools(): StructuredToolInterface[];

package/dist/src/managers/server_manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAU7C,qBAAa,aAAa;IACxB,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAK;IAChE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAK;IAE3E,SAAgB,MAAM,EAAE,SAAS,CAAA;IACjC,SAAgB,OAAO,EAAE,gBAAgB,CAAA;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAO;gBAE7B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB;IAKxD,UAAU,IAAI,IAAI;IAOZ,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD1C,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAOrC;CACF"}
+{"version":3,"file":"server_manager.d.ts","sourceRoot":"","sources":["../../../src/managers/server_manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAW7C,qBAAa,aAAa;IACxB,SAAgB,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAK;IAChE,SAAgB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAK;IAE3E,SAAgB,MAAM,EAAE,SAAS,CAAA;IACjC,SAAgB,OAAO,EAAE,gBAAgB,CAAA;IAClC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAO;gBAE7B,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB;IAKjD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAqBtC,UAAU,IAAI,IAAI;IAOZ,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoD1C,IAAI,KAAK,IAAI,uBAAuB,EAAE,CAsBrC;CACF"}

package/dist/src/managers/server_manager.js

@@ -1,6 +1,7 @@
 import { isEqual } from 'lodash-es';
 import { logger } from '../logging.js';
 import { AcquireActiveMCPServerTool } from './tools/acquire_active_mcp_server.js';
+import { AddMCPServerTool } from './tools/add_server.js';
 import { ConnectMCPServerTool } from './tools/connect_mcp_server.js';
 import { ListMCPServersTool } from './tools/list_mcp_servers.js';
 import { ReleaseMCPServerConnectionTool } from './tools/release_mcp_server_connection.js';
@@ -14,10 +15,27 @@ export class ServerManager {
         this.client = client;
         this.adapter = adapter;
     }
+    logState(context) {
+        const allServerNames = this.client.getServerNames();
+        const activeSessionNames = Object.keys(this.client.getAllActiveSessions());
+        if (allServerNames.length === 0) {
+            logger.info('Server Manager State: No servers configured.');
+            return;
+        }
+        const tableData = allServerNames.map(name => ({
+            'Server Name': name,
+            'Connected': activeSessionNames.includes(name) ? '✅' : '❌',
+            'Initialized': this.initializedServers[name] ? '✅' : '❌',
+            'Tool Count': this.serverTools[name]?.length ?? 0,
+            'Active': this.activeServer === name ? '✅' : '❌',
+        }));
+        logger.info(`Server Manager State: [${context}]`);
+        console.table(tableData); // eslint-disable-line no-console
+    }
     initialize() {
         const serverNames = this.client.getServerNames?.();
         if (serverNames.length === 0) {
-            logger.warning('No MCP servers defined in client configuration');
+            logger.warn('No MCP servers defined in client configuration');
         }
     }
     async prefetchServerTools() {
@@ -62,11 +80,21 @@ export class ServerManager {
         }
     }
     get tools() {
-        return [
+        if (logger.level === 'debug') {
+            this.logState('Providing tools to agent');
+        }
+        const managementTools = [
+            new AddMCPServerTool(this),
             new ListMCPServersTool(this),
             new ConnectMCPServerTool(this),
             new AcquireActiveMCPServerTool(this),
             new ReleaseMCPServerConnectionTool(this),
         ];
+        if (this.activeServer && this.serverTools[this.activeServer]) {
+            const activeTools = this.serverTools[this.activeServer];
+            logger.debug(`Adding ${activeTools.length} tools from active server '${this.activeServer}'`);
+            return [...managementTools, ...activeTools];
+        }
+        return managementTools;
     }
 }

package/dist/src/managers/tools/add_server.d.ts

@@ -0,0 +1,21 @@
+import type { ServerManager } from '../server_manager.js';
+import { StructuredTool } from 'langchain/tools';
+import { z } from 'zod';
+export declare class AddMCPServerTool extends StructuredTool {
+    name: string;
+    description: string;
+    schema: z.ZodObject<{
+        serverName: z.ZodString;
+        serverConfig: z.ZodAny;
+    }, "strip", z.ZodTypeAny, {
+        serverName: string;
+        serverConfig?: any;
+    }, {
+        serverName: string;
+        serverConfig?: any;
+    }>;
+    private manager;
+    constructor(manager: ServerManager);
+    protected _call({ serverName, serverConfig, }: z.infer<typeof this.schema>): Promise<string>;
+}
+//# sourceMappingURL=add_server.d.ts.map

package/dist/src/managers/tools/add_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add_server.d.ts","sourceRoot":"","sources":["../../../../src/managers/tools/add_server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,qBAAa,gBAAiB,SAAQ,cAAc;IAClD,IAAI,SAAmB;IACvB,WAAW,SAC8E;IAEzF,MAAM;;;;;;;;;OAOJ;IAEF,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,EAAE,aAAa;cAKlB,KAAK,CAAC,EACpB,UAAU,EACV,YAAY,GACb,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CA6BjD"}

package/dist/src/managers/tools/add_server.js

@@ -0,0 +1,40 @@
+import { StructuredTool } from 'langchain/tools';
+import { z } from 'zod';
+import { logger } from '../../logging.js';
+export class AddMCPServerTool extends StructuredTool {
+    name = 'add_mcp_server';
+    description = 'Adds a new MCP server to the client and connects to it, making its tools available.';
+    schema = z.object({
+        serverName: z.string().describe('The name for the new MCP server.'),
+        serverConfig: z
+            .any()
+            .describe('The configuration object for the server. This should not include the top-level "mcpServers" key.'),
+    });
+    manager;
+    constructor(manager) {
+        super();
+        this.manager = manager;
+    }
+    async _call({ serverName, serverConfig, }) {
+        try {
+            this.manager.client.addServer(serverName, serverConfig);
+            let result = `Server '${serverName}' added to the client.`;
+            logger.debug(`Connecting to new server '${serverName}' and discovering tools.`);
+            const session = await this.manager.client.createSession(serverName);
+            const connector = session.connector;
+            const tools = await this.manager.adapter.createToolsFromConnectors([connector]);
+            this.manager.serverTools[serverName] = tools;
+            this.manager.initializedServers[serverName] = true;
+            this.manager.activeServer = serverName; // Set as active server
+            const numTools = tools.length;
+            result += ` Session created and connected. '${serverName}' is now the active server with ${numTools} tools available.`;
+            result += `\n\n${tools.map(t => t.name).join('\n')}`;
+            logger.info(result);
+            return result;
+        }
+        catch (e) {
+            logger.error(`Failed to add or connect to server '${serverName}': ${e.message}`);
+            return `Failed to add or connect to server '${serverName}': ${e.message}`;
+        }
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-use",
   "type": "module",
-  "version": "0.0.8",
+  "version": "0.1.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.",
   "author": "Zane",
@@ -55,13 +55,27 @@
     "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"
+    "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: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"
   },
   "dependencies": {
     "@dmitryrechkin/json-schema-to-zod": "^1.0.1",
+    "@langchain/anthropic": "^0.3.14",
     "@langchain/community": "0.3.45",
     "@langchain/core": "0.3.58",
+    "@langchain/openai": "^0.5.15",
     "@modelcontextprotocol/sdk": "1.12.1",
+    "dotenv": "^16.5.0",
     "eventsource": "^3.0.6",
     "fastembed": "^1.14.4",
     "langchain": "^0.3.27",
@@ -85,8 +99,10 @@
   },
   "lint-staged": {
     "*.{js,ts}": [
-      "eslint --fix",
-      "git add"
+      "npm run lint"
+    ],
+    "**/*.ts": [
+      "npm run build"
     ]
   }
 }