@h1deya/langchain-mcp-tools 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,11 @@
-# MCP Server To LangChain Tools Conversion Utility [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@h1deya/langchain-mcp-tools.svg)](https://www.npmjs.com/package/@h1deya/langchain-mcp-tools)
+# MCP To LangChain Tools Conversion Utility [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/hideya/langchain-mcp-tools-ts/blob/main/LICENSE) [![npm version](https://img.shields.io/npm/v/@h1deya/langchain-mcp-tools.svg)](https://www.npmjs.com/package/@h1deya/langchain-mcp-tools)
 
 This package is intended to simplify the use of MCP server tools within LangChain.
 
-It contains a utility function `convertMCPServersToLangChainTools()`
+It contains a utility function `convertMcpToLangchainTools()`
 that initializes specified MCP servers,
 and returns [LangChain Tools](https://js.langchain.com/docs/how_to/tool_calling/)
-that wrap all the available MCP server tools.
+that wrap all the tools found in given MCP servers.
 
 ## Installation
 
@@ -15,14 +15,14 @@ npm i @h1deya/langchain-mcp-tools
 
 ## Quick Start
 
-`convertMCPServersToLangChainTools()` utility function accepts MCP server configuration
-in pretty much the same format as a JS Object interpretation of the JSON format used by
-[Claude for Desktop](https://modelcontextprotocol.io/quickstart/user)
-(it just needs the contents of the `mcpServers` property).
-e.g.:
+`convertMcpToLangchainTools()` utility function accepts MCP server configuration
+that follows the same structure as
+[Claude for Desktop](https://modelcontextprotocol.io/quickstart/user),
+but only the contents of the `mcpServers` property,
+and is expressed as a JS Object, e.g.:
 
 ```ts
-const mcpServers: MCPServersConfig = {
+const mcpServers: McpServersConfig = {
   filesystem: {
     command: 'npx',
     args: [
@@ -39,10 +39,10 @@ const mcpServers: MCPServersConfig = {
   }
 };
 
-const { tools, cleanup } = await convertMCPServersToLangChainTools(mcpServers);
+const { tools, cleanup } = await convertMcpToLangchainTools(mcpServers);
 ```
 
-The utility function initializes all the MCP server connections concurrently,
+The utility function initializes all specified MCP servers in parallel,
 and returns LangChain Tools (`tools: DynamicStructuredTool[]`)
 by gathering all the available MCP server tools,
 and by wrapping them into [LangChain Tools](https://js.langchain.com/docs/how_to/tool_calling/).
@@ -52,6 +52,7 @@ which is used to close all the connections to the MCP servers when finished.
 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' });
 
 // import { createReactAgent } from '@langchain/langgraph/prebuilt';

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

@@ -1,20 +1,20 @@
 import { DynamicStructuredTool } from '@langchain/core/tools';
-interface MCPServerConfig {
+interface McpServerConfig {
     command: string;
     args: readonly string[];
     env?: Readonly<Record<string, string>>;
 }
-export interface MCPServersConfig {
-    [key: string]: MCPServerConfig;
+export interface McpServersConfig {
+    [key: string]: McpServerConfig;
 }
 interface LogOptions {
     logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
 }
-export interface MCPServerCleanupFunction {
+export interface McpServerCleanupFunction {
     (): Promise<void>;
 }
-export declare function convertMCPServersToLangChainTools(configs: MCPServersConfig, options?: LogOptions): Promise<{
+export declare function convertMcpToLangchainTools(configs: McpServersConfig, options?: LogOptions): Promise<{
     tools: DynamicStructuredTool[];
-    cleanup: MCPServerCleanupFunction;
+    cleanup: McpServerCleanupFunction;
 }>;
 export {};

package/dist/langchain-mcp-tools.js

@@ -16,12 +16,12 @@ class MCPInitializationError extends Error {
     }
 }
 // Primary function to convert multiple MCP servers to LangChain tools
-export async function convertMCPServersToLangChainTools(configs, options) {
+export async function convertMcpToLangchainTools(configs, options) {
     const allTools = [];
     const cleanupCallbacks = [];
     const logger = new Logger({ level: options?.logLevel || 'info' });
     const serverInitPromises = Object.entries(configs).map(async ([name, config]) => {
-        const result = await convertMCPServerToLangChainTools(name, config, logger);
+        const result = await convertSingleMcpToLangchainTools(name, config, logger);
         return { name, result };
     });
     // Track server names alongside their promises
@@ -54,7 +54,7 @@ export async function convertMCPServersToLangChainTools(configs, options) {
     return { tools: allTools, cleanup };
 }
 // Convert a single MCP server into LangChain tools
-async function convertMCPServerToLangChainTools(serverName, config, logger) {
+async function convertSingleMcpToLangchainTools(serverName, config, logger) {
     let transport = null;
     let client = null;
     logger.info(`MCP server "${serverName}": initializing with: ${JSON.stringify(config)}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h1deya/langchain-mcp-tools",
-  "version": "0.1.1",
-  "description": "A utility that wraps MCP servers into LangChain tools",
+  "version": "0.1.3",
+  "description": "MCP To LangChain Tools Conversion Utility",
   "license": "MIT",
   "keywords": [
     "modelcontextprotocol",