@h1deya/langchain-mcp-tools 0.1.11 → 0.1.12

package/README.md

@@ -5,35 +5,32 @@ This package is intended to simplify the use of
 server tools with LangChain / TypeScript.
 
 [Model Context Protocol (MCP)](https://modelcontextprotocol.io/),
-introduced by
-[Anthropic](https://www.anthropic.com/news/model-context-protocol),
-extends the capabilities of LLMs by enabling interaction with external tools and resources,
-such as web search and database access.
-Thanks to its open-source nature, MCP has gained significant traction in the developer community,
-with over 400 MCP servers already developed and shared:
+an open source technology
+[announced by Anthropic](https://www.anthropic.com/news/model-context-protocol),
+dramatically expands LLM’s scope
+by enabling external tool and resource integration, including
+Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
+
+Over 450 functional components available as MCP servers:
 
 - [Glama’s list of Open-Source MCP servers](https://glama.ai/mcp/servers)
 - [Smithery: MCP Server Registry](https://smithery.ai/)
 - [awesome-mcp-servers](https://github.com/hideya/awesome-mcp-servers#Server-Implementations)
 - [MCP Get Started/Example Servers](https://modelcontextprotocol.io/examples)
 
-In the MCP framework, external features are encapsulated in an MCP server,
-which typically runs in a separate process and communicates
-via `stdio` using the open standard protocol.
-This clean decoupling makes it easy to adopt and reuse any of
-the significant collections of MCP servers listed above.
-
-To make it easy for LangChain users to take advantage of such a vast resource base,
-this package offers quick and seamless access from LangChain to MCP servers.
+The goal of this utility is to make these 450+ 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 450+ 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)
 
-## Requirements
+## Prerequisites
 
 - Node.js 16+
 
@@ -78,7 +75,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-haiku-latest' });
+const llm = new ChatAnthropic({ model: 'claude-3-5-sonnet-latest' });
 
 // import { createReactAgent } from '@langchain/langgraph/prebuilt';
 const agent = createReactAgent({
@@ -86,11 +83,15 @@ const agent = createReactAgent({
   tools
 });
 ```
-A simple and experimentable usage example can be found
+
+Find complete, minimal working usage examples
 [here](https://github.com/hideya/langchain-mcp-tools-ts-usage/blob/main/src/index.ts)
 
-A more realistic usage example can be found
-[here](https://github.com/hideya/langchain-mcp-client-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 450+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 ## Limitations
 

package/dist/langchain-mcp-tools.js

@@ -131,16 +131,19 @@ async function convertSingleMcpToLangchainTools(serverName, config, logger) {
                         arguments: input,
                     },
                 }, CallToolResultSchema);
-                const resultStringfied = JSON.stringify(result?.content);
-                const roughLength = resultStringfied.length;
-                logger.info(`MCP tool "${serverName}"/"${tool.name}" received result (length: ${roughLength})`);
-                logger.debug('result:', result?.content);
-                return resultStringfied;
-                // const filteredResult = result?.content
-                //   .filter(content => content.type === 'text')
-                //   .map(content => content.text)
-                //   .join('\n\n');
-                // return filteredResult;
+                // Handles null/undefined cases gracefully
+                if (!result?.content) {
+                    logger.info(`MCP tool "${serverName}"/"${tool.name}" received null/undefined result`);
+                    return '';
+                }
+                // For multiple content pieces or mixed types
+                const textContent = result.content
+                    .filter(content => content.type === 'text')
+                    .map(content => content.text)
+                    .join('\n\n');
+                logger.info(`MCP tool "${serverName}"/"${tool.name}" received result (length: ${textContent.length})`);
+                // If no text content, return a clear message describing the situation
+                return textContent || 'No text content available in response';
             },
         })));
         logger.info(`MCP server "${serverName}": ${tools.length} tool(s) available:`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@h1deya/langchain-mcp-tools",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "MCP To LangChain Tools Conversion Utility",
   "license": "MIT",
   "keywords": [