@h1deya/langchain-mcp-tools 0.1.11 → 0.1.13

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

@@ -121,26 +121,40 @@ async function convertSingleMcpToLangchainTools(serverName, config, logger) {
             // FIXME
             // eslint-disable-next-line @typescript-eslint/no-explicit-any
             schema: jsonSchemaToZod(tool.inputSchema),
-            func: async (input) => {
+            func: async function (input) {
                 logger.info(`MCP tool "${serverName}"/"${tool.name}" received input:`, input);
-                // Execute tool call
-                const result = await client?.request({
-                    method: "tools/call",
-                    params: {
-                        name: tool.name,
-                        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;
+                try {
+                    // Execute tool call
+                    const result = await client?.request({
+                        method: "tools/call",
+                        params: {
+                            name: tool.name,
+                            arguments: input,
+                        },
+                    }, CallToolResultSchema);
+                    // Handles null/undefined cases gracefully
+                    if (!result?.content) {
+                        logger.info(`MCP tool "${serverName}"/"${tool.name}" received null/undefined result`);
+                        return '';
+                    }
+                    const textContent = result.content
+                        .filter(content => content.type === 'text')
+                        .map(content => content.text)
+                        .join('\n\n');
+                    // const textItems = result.content
+                    //   .filter(content => content.type === 'text')
+                    //   .map(content => content.text)
+                    // const textContent = JSON.stringify(textItems);
+                    // Log rough result size for monitoring
+                    const size = new TextEncoder().encode(textContent).length;
+                    logger.info(`MCP tool "${serverName}"/"${tool.name}" received result (size: ${size})`);
+                    // If no text content, return a clear message describing the situation
+                    return textContent || 'No text content available in response';
+                }
+                catch (error) {
+                    logger.warn(`MCP tool "${serverName}"/"${tool.name}" caused error: ${error}`);
+                    return `Error executing MCP tool: ${error}`;
+                }
             },
         })));
         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.13",
   "description": "MCP To LangChain Tools Conversion Utility",
   "license": "MIT",
   "keywords": [
@@ -33,11 +33,14 @@
     "build": "tsc",
     "prepare": "npm run build",
     "watch": "tsc --watch",
+    "example": "tsx examples/example.ts",
     "lint": "eslint src",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
-    "clean": "git clean -fdxn -e .env && read -p 'OK?' && git clean -fdx -e .env"
+    "clean": "git clean -fdxn -e .env && read -p 'OK?' && git clean -fdx -e .env",
+    "do-publish": "npm run clean && npm install && npm publish --access=public",
+    "publish-dry-run": "npm run clean && npm install && npm publish --access=public --dry-run"
   },
   "dependencies": {
     "@langchain/core": "^0.3.27",
@@ -47,11 +50,16 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.17.0",
+    "@langchain/anthropic": "^0.3.11",
+    "@langchain/langgraph": "^0.2.36",
+    "@langchain/openai": "^0.3.16",
     "@types/node": "^22.10.5",
     "@typescript-eslint/eslint-plugin": "^8.19.0",
     "@typescript-eslint/parser": "^8.19.0",
     "@vitest/coverage-v8": "^2.1.8",
+    "dotenv": "^16.4.7",
     "eslint": "^9.17.0",
+    "tsx": "^4.19.3",
     "typescript": "^5.7.2",
     "typescript-eslint": "^8.19.0",
     "vitest": "^2.1.8"