@h1deya/langchain-mcp-tools 0.1.18 → 0.1.20

package/README.md

@@ -11,21 +11,20 @@ dramatically expands LLM’s scope
 by enabling external tool and resource integration, including
 Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
 
-Over 1500 functional components available as MCP servers:
+Over 2000 functional components available as MCP servers:
 
+- [MCP Server Listing on the Official Site](https://github.com/modelcontextprotocol/servers?tab=readme-ov-file#model-context-protocol-servers)
 - [MCP.so - Find Awesome MCP Servers and Clients](https://mcp.so/)
 - [Smithery: MCP Server Registry](https://smithery.ai/)
-- [pulse - Browse and discover MCP use cases, servers, clients, and news](https://www.pulsemcp.com/)
-- [MCP Get Started/Example Servers](https://modelcontextprotocol.io/examples)
 
-The goal of this utility is to make these 1500+ MCP servers readily accessible from LangChain.
+The goal of this utility is to make these 2000+ MCP servers readily accessible from LangChain.
 
 It contains a utility function `convertMcpToLangchainTools()`.  
 This async function handles parallel initialization of specified multiple MCP servers
 and converts their available tools into an array of LangChain-compatible tools.
 
 For detailed information on how to use this library, please refer to the following document:
-- ["Supercharging LangChain: Integrating 1500+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-1500-mcp-with-react-d4e467cbf41a)
+- ["Supercharging LangChain: Integrating 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 A python equivalent of this utility is available
 [here](https://pypi.org/project/langchain-mcp-tools)
@@ -75,7 +74,7 @@ The returned tools can be used with LangChain, e.g.:
 
 ```ts
 // import { ChatAnthropic } from '@langchain/anthropic';
-const llm = new ChatAnthropic({ model: 'claude-3-5-sonnet-latest' });
+const llm = new ChatAnthropic({ model: 'claude-3-7-sonnet-latest' });
 
 // import { createReactAgent } from '@langchain/langgraph/prebuilt';
 const agent = createReactAgent({
@@ -91,12 +90,16 @@ For hands-on experimentation with MCP server integration,
 try [this LangChain application built with the utility](https://github.com/hideya/mcp-client-langchain-ts)
 
 For detailed information on how to use this library, please refer to the following document:  
-["Supercharging LangChain: Integrating 1500+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-1500-mcp-with-react-d4e467cbf41a)
+["Supercharging LangChain: Integrating 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 ## Limitations
 
 Currently, only text results of tool calls are supported.
 
+Remote MCP server is not supported.
+
+Fatures other than [Tools](https://modelcontextprotocol.io/docs/concepts/tools) are not supported.
+
 ## Change Log
 
 Can be found [here](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/CHANGELOG.md)

package/dist/langchain-mcp-tools.d.ts

@@ -1,18 +1,13 @@
 import { StructuredTool } from '@langchain/core/tools';
-interface McpServerConfig {
-    command: string;
-    args: readonly string[];
-    env?: Readonly<Record<string, string>>;
-    errlog?: number;
-}
+import { StdioServerParameters } from "@modelcontextprotocol/sdk/client/stdio.js";
 export interface McpServersConfig {
-    [key: string]: McpServerConfig;
+    [key: string]: StdioServerParameters;
 }
 export interface McpToolsLogger {
-    debug(message: string, ...args: any[]): void;
-    info(message: string, ...args: any[]): void;
-    warn(message: string, ...args: any[]): void;
-    error(message: string, ...args: any[]): void;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
 }
 interface LogOptions {
     logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';

package/dist/langchain-mcp-tools.js

@@ -1,7 +1,9 @@
+import { DynamicStructuredTool } from '@langchain/core/tools';
 import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";
 import { CallToolResultSchema, ListToolsResultSchema } from '@modelcontextprotocol/sdk/types.js';
-import { DynamicStructuredTool } from '@langchain/core/tools';
 import { jsonSchemaToZod } from '@n8n/json-schema-to-zod';
 import { Logger } from './logger.js';
 // Custom error type for MCP server initialization failures
@@ -104,12 +106,29 @@ async function convertSingleMcpToLangchainTools(serverName, config, logger) {
         env.PATH = process.env.PATH || '';
     }
     try {
-        transport = new StdioClientTransport({
-            command: config.command,
-            args: config.args,
-            env: env,
-            stderr: config.errlog
-        });
+        const url_or_command = config.command;
+        let url = undefined;
+        try {
+            url = new URL(url_or_command);
+        }
+        catch {
+            // Ignore
+        }
+        if (url?.protocol === "http:" || url?.protocol === "https:") {
+            transport = new SSEClientTransport(new URL(url_or_command));
+        }
+        else if (url?.protocol === "ws:" || url?.protocol === "wss:") {
+            transport = new WebSocketClientTransport(new URL(url_or_command));
+        }
+        else {
+            transport = new StdioClientTransport({
+                command: url_or_command,
+                args: config.args,
+                env,
+                stderr: config.stderr,
+                cwd: config.cwd
+            });
+        }
         client = new Client({
             name: "mcp-client",
             version: "0.0.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1deya/langchain-mcp-tools",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "MCP To LangChain Tools Conversion Utility",
   "license": "MIT",
   "keywords": [
@@ -33,7 +33,7 @@
     "build": "tsc",
     "prepare": "npm run build",
     "watch": "tsc --watch",
-    "example": "tsx examples/example.ts",
+    "simple-usage": "tsx testfiles/simple-usage.ts",
     "lint": "eslint src",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@langchain/core": "^0.3.27",
-    "@modelcontextprotocol/sdk": "^1.1.0",
+    "@modelcontextprotocol/sdk": "^1.8.0",
     "@n8n/json-schema-to-zod": "^1.1.0",
     "zod": "^3.24.1"
   },