@h1deya/langchain-mcp-tools 0.2.0 → 0.2.2

package/README.md

@@ -5,11 +5,14 @@ This package is intended to simplify the use of
 server tools with LangChain / TypeScript.
 
 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/),
-an open source technology
+an open standard
 [announced by Anthropic](https://www.anthropic.com/news/model-context-protocol),
-dramatically expands LLM’s scope
+dramatically expands LLM's scope
 by enabling external tool and resource integration, including
-Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
+GitHub, Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
+
+MCP is likely to become the de facto industry standard as 
+[OpenAI has announced its adoption](https://techcrunch.com/2025/03/26/openai-adopts-rival-anthropics-standard-for-connecting-ai-models-to-data).
 
 Over 2000 functional components available as MCP servers:
 
@@ -24,7 +27,7 @@ This async function handles parallel initialization of specified multiple MCP se
 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 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-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)
@@ -41,6 +44,9 @@ npm i @h1deya/langchain-mcp-tools
 
 ## Quick Start
 
+A minimal but complete working usage example can be found
+[in this example in the langchain-mcp-tools-ts-usage repo](https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/main/src/index.ts)
+
 `convertMcpToLangchainTools()` utility function accepts MCP server configurations
 that follow the same structure as
 [Claude for Desktop](https://modelcontextprotocol.io/quickstart/user),
@@ -83,14 +89,11 @@ const agent = createReactAgent({
 });
 ```
 
-Find complete, minimal working usage examples
-[here](https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/main/src/index.ts)
-
 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 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
+["Supercharging LangChain: Integrating 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 ## Experimental Features
 
@@ -112,9 +115,57 @@ Note that the key `"url"` may be changed in the future to match
 the MCP server configurations used by Claude for Desktop once
 it introduces remote server support.
 
+A usage example can be found [here](
+https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/694b877ed5336bfcd5274d95d3f6d14bed0937a6/src/index.ts#L26-L38)
+
+### Authentication Support for SSE Connections
+
+The library now supports authentication for SSE connections to MCP servers.
+This is particularly useful for accessing authenticated MCP servers that require OAuth.
+
+To enable authentication, provide SSE options in your server configuration:
+
+```ts
+import { OAuthClientProvider } from '@modelcontextprotocol/sdk/client/auth.js';
+
+// Implement your own OAuth client provider
+class MyOAuthProvider implements OAuthClientProvider {
+  // Implementation details...
+}
+
+const mcpServers = {
+  "secure-server": {
+    url: "https://secure-mcp-server.example.com",
+    sseOptions: {
+      // Provide an OAuth client provider
+      authProvider: new MyOAuthProvider(),
+      
+      // Optionally customize the initial SSE request
+      eventSourceInit: {
+        // Custom options
+      },
+      
+      // Optionally customize recurring POST requests
+      requestInit: {
+        headers: {
+          'X-Custom-Header': 'custom-value'
+        }
+      }
+    }
+  }
+};
+```
+
+A simple but complete example showing how to implement an OAuth client provider can be found
+in the [sse-auth-test-client.ts](https://github.com/hideya/langchain-mcp-tools-ts/tree/main/testfiles/sse-auth-test-client.ts) file.  
+Note that this is test code for this library and does not use the npm.js library.
+
+FYI, a sample MCP server with OAuth authentication support is also provided
+in [sse-auth-test-server.ts](https://github.com/hideya/langchain-mcp-tools-ts/tree/main/testfiles/sse-auth-test-server.ts).  
+
 ### Working Directory Configuration for Local MCP Servers
 
-The working directory that is used when spawning a local MCP server
+The working directory that is used when spawning a local (stdio) MCP server
 can be specified with the `"cwd"` key as follows:
 
 ```ts
@@ -125,10 +176,13 @@ can be specified with the `"cwd"` key as follows:
     },
 ```
 
-### Configuration for MCP Server stderr Redirection
+The key name `cwd` is derived from TypeScript SDK's `StdioServerParameters`.
+
+### Configuration for Local MCP Server `stderr` Redirection
 
 A new key `"stderr"` has been introduced to specify a file descriptor
-to which MCP server's stderr is redirected.
+to which local (stdio) MCP server's stderr is redirected.  
+The key name `stderr` is derived from TypeScript SDK's `StdioServerParameters`.
 
 ```ts
     const logPath = `mcp-server-${serverName}.log`;
@@ -136,12 +190,13 @@ to which MCP server's stderr is redirected.
     mcpServers[serverName].stderr = logFd;
 ```
 
-The key `stderr` is derived from TypeScript SDK's `StdioServerParameters`.
+A usage example can be found [here](
+https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/694b877ed5336bfcd5274d95d3f6d14bed0937a6/src/index.ts#L72-L83)
 
 ## Limitations
 
 - Currently, only text results of tool calls are supported.
-- Fatures other than [Tools](https://modelcontextprotocol.io/docs/concepts/tools) are not supported.
+- MCP features other than [Tools](https://modelcontextprotocol.io/docs/concepts/tools) are not supported.
 
 ## Change Log
 

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

@@ -1,6 +1,7 @@
 import { IOType } from "node:child_process";
 import { Stream } from "node:stream";
 import { StructuredTool } from "@langchain/core/tools";
+import { OAuthClientProvider } from "@modelcontextprotocol/sdk/client/auth.js";
 interface CommandBasedConfig {
     url?: never;
     command: string;
@@ -16,6 +17,11 @@ interface UrlBasedConfig {
     env?: never;
     stderr?: never;
     cwd?: never;
+    sseOptions?: {
+        authProvider?: OAuthClientProvider;
+        eventSourceInit?: EventSourceInit;
+        requestInit?: RequestInit;
+    };
 }
 type McpServerConfig = CommandBasedConfig | UrlBasedConfig;
 export interface McpServersConfig {

package/dist/langchain-mcp-tools.js

@@ -107,7 +107,22 @@ async function convertSingleMcpToLangchainTools(serverName, config, logger) {
             // Ignore
         }
         if (url?.protocol === "http:" || url?.protocol === "https:") {
-            transport = new SSEClientTransport(url);
+            // Extract SSE options from config if available
+            const urlConfig = config;
+            const sseOptions = {};
+            if (urlConfig.sseOptions) {
+                if (urlConfig.sseOptions.authProvider) {
+                    sseOptions.authProvider = urlConfig.sseOptions.authProvider;
+                    logger.info(`MCP server "${serverName}": configuring SSE with authentication provider`);
+                }
+                if (urlConfig.sseOptions.eventSourceInit) {
+                    sseOptions.eventSourceInit = urlConfig.sseOptions.eventSourceInit;
+                }
+                if (urlConfig.sseOptions.requestInit) {
+                    sseOptions.requestInit = urlConfig.sseOptions.requestInit;
+                }
+            }
+            transport = new SSEClientTransport(url, Object.keys(sseOptions).length > 0 ? sseOptions : undefined);
         }
         else if (url?.protocol === "ws:" || url?.protocol === "wss:") {
             transport = new WebSocketClientTransport(url);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1deya/langchain-mcp-tools",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP To LangChain Tools Conversion Utility",
   "license": "MIT",
   "keywords": [
@@ -34,6 +34,9 @@
     "prepare": "npm run build",
     "watch": "tsc --watch",
     "simple-usage": "tsx testfiles/simple-usage.ts",
+    "direct-test": "tsx -- testfiles/direct-test.ts",
+    "sse-auth-test-client": "tsx testfiles/sse-auth-test-client.ts",
+    "sse-auth-test-server": "tsx testfiles/sse-auth-test-server.ts",
     "lint": "eslint src",
     "test": "vitest run",
     "test:watch": "vitest",
@@ -46,7 +49,6 @@
     "@langchain/core": "^0.3.27",
     "@modelcontextprotocol/sdk": "^1.8.0",
     "@n8n/json-schema-to-zod": "^1.1.0",
-    "ws": "^8.18.1",
     "zod": "^3.24.1"
   },
   "devDependencies": {
@@ -58,11 +60,15 @@
     "@typescript-eslint/eslint-plugin": "^8.19.0",
     "@typescript-eslint/parser": "^8.19.0",
     "@vitest/coverage-v8": "^3.0.9",
+    "cors": "^2.8.5",
     "dotenv": "^16.4.7",
     "eslint": "^9.17.0",
+    "express": "^4.19.2",
     "tsx": "^4.19.3",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.19.0",
-    "vitest": "^3.0.9"
+    "uuid": "^9.0.1",
+    "vitest": "^3.0.9",
+    "ws": "^8.18.1"
   }
 }