@h1deya/langchain-mcp-tools 0.1.16 → 0.1.18

package/README.md

@@ -13,9 +13,9 @@ Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
 
 Over 1500 functional components available as MCP servers:
 
-- [Glama’s list of Open-Source MCP servers](https://glama.ai/mcp/servers)
+- [MCP.so - Find Awesome MCP Servers and Clients](https://mcp.so/)
 - [Smithery: MCP Server Registry](https://smithery.ai/)
-- [awesome-mcp-servers](https://github.com/hideya/awesome-mcp-servers#Server-Implementations)
+- [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.

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

@@ -3,10 +3,17 @@ interface McpServerConfig {
     command: string;
     args: readonly string[];
     env?: Readonly<Record<string, string>>;
+    errlog?: number;
 }
 export interface McpServersConfig {
     [key: string]: McpServerConfig;
 }
+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;
+}
 interface LogOptions {
     logLevel?: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
 }
@@ -18,7 +25,10 @@ export interface McpServerCleanupFn {
  * This function concurrently sets up all specified servers and aggregates their tools.
  *
  * @param configs - A mapping of server names to their respective configurations
- * @param options - Optional logging configuration
+ * @param options - Optional configuration settings
+ * @param options.logLevel - Log verbosity level ('fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace')
+ * @param options.logger - Custom logger implementation that follows the McpToolsLogger interface.
+ *                        If provided, overrides the default Logger instance.
  *
  * @returns A promise that resolves to:
  *          - tools: Array of StructuredTool instances ready for use with LangChain
@@ -32,7 +42,9 @@ export interface McpServerCleanupFn {
  *   fetch: { command: 'uvx', args: ['mcp-server-fetch'] }
  * });
  */
-export declare function convertMcpToLangchainTools(configs: McpServersConfig, options?: LogOptions): Promise<{
+export declare function convertMcpToLangchainTools(configs: McpServersConfig, options?: LogOptions & {
+    logger?: McpToolsLogger;
+}): Promise<{
     tools: StructuredTool[];
     cleanup: McpServerCleanupFn;
 }>;

package/dist/langchain-mcp-tools.js

@@ -20,7 +20,10 @@ class McpInitializationError extends Error {
  * This function concurrently sets up all specified servers and aggregates their tools.
  *
  * @param configs - A mapping of server names to their respective configurations
- * @param options - Optional logging configuration
+ * @param options - Optional configuration settings
+ * @param options.logLevel - Log verbosity level ('fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace')
+ * @param options.logger - Custom logger implementation that follows the McpToolsLogger interface.
+ *                        If provided, overrides the default Logger instance.
  *
  * @returns A promise that resolves to:
  *          - tools: Array of StructuredTool instances ready for use with LangChain
@@ -37,7 +40,7 @@ class McpInitializationError extends Error {
 export async function convertMcpToLangchainTools(configs, options) {
     const allTools = [];
     const cleanupCallbacks = [];
-    const logger = new Logger({ level: options?.logLevel || 'info' });
+    const logger = options?.logger || new Logger({ level: options?.logLevel || 'info' });
     const serverInitPromises = Object.entries(configs).map(async ([name, config]) => {
         const result = await convertSingleMcpToLangchainTools(name, config, logger);
         return { name, result };
@@ -78,7 +81,7 @@ export async function convertMcpToLangchainTools(configs, options) {
  *
  * @param serverName - Unique identifier for the server instance
  * @param config - Server configuration including command, arguments, and environment variables
- * @param logger - Logger instance for recording operation details
+ * @param logger - McpToolsLogger instance for recording operation details
  *
  * @returns A promise that resolves to:
  *          - tools: Array of StructuredTool instances from this server
@@ -105,6 +108,7 @@ async function convertSingleMcpToLangchainTools(serverName, config, logger) {
             command: config.command,
             args: config.args,
             env: env,
+            stderr: config.errlog
         });
         client = new Client({
             name: "mcp-client",

package/dist/logger.d.ts

@@ -16,12 +16,11 @@ declare class Logger {
     private parseLogLevel;
     private log;
     private formatValue;
-    private createLogMethod;
-    trace: (...args: unknown[]) => void;
-    debug: (...args: unknown[]) => void;
-    info: (...args: unknown[]) => void;
-    warn: (...args: unknown[]) => void;
-    error: (...args: unknown[]) => void;
-    fatal: (...args: unknown[]) => void;
+    trace(...args: unknown[]): void;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    fatal(...args: unknown[]): void;
 }
 export { Logger, LogLevel, LogLevelString };

package/dist/logger.js

@@ -49,14 +49,11 @@ class Logger {
             return 'undefined';
         return typeof value === 'object' ? JSON.stringify(value, null, 2) : String(value);
     }
-    createLogMethod(level) {
-        return (...args) => this.log(level, ...args);
-    }
-    trace = this.createLogMethod(LogLevel.TRACE);
-    debug = this.createLogMethod(LogLevel.DEBUG);
-    info = this.createLogMethod(LogLevel.INFO);
-    warn = this.createLogMethod(LogLevel.WARN);
-    error = this.createLogMethod(LogLevel.ERROR);
-    fatal = this.createLogMethod(LogLevel.FATAL);
+    trace(...args) { this.log(LogLevel.TRACE, ...args); }
+    debug(...args) { this.log(LogLevel.DEBUG, ...args); }
+    info(...args) { this.log(LogLevel.INFO, ...args); }
+    warn(...args) { this.log(LogLevel.WARN, ...args); }
+    error(...args) { this.log(LogLevel.ERROR, ...args); }
+    fatal(...args) { this.log(LogLevel.FATAL, ...args); }
 }
 export { Logger, LogLevel };

package/package.json

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