langchain-mcp-tools 0.1.9__py3-none-any.whl → 0.1.11__py3-none-any.whl

langchain_mcp_tools/langchain_mcp_tools.py

@@ -24,8 +24,8 @@ from typing import (
 try:
     from jsonschema_pydantic import jsonschema_to_pydantic  # type: ignore
     from langchain_core.tools import BaseTool, ToolException
-    from mcp import ClientSession, StdioServerParameters
-    from mcp.client.stdio import stdio_client
+    from mcp import ClientSession
+    from mcp.client.stdio import stdio_client, StdioServerParameters
     import mcp.types as mcp_types
     from pydantic import BaseModel
     # from pydantic_core import to_json
@@ -90,12 +90,23 @@ async def spawn_mcp_server_and_get_transport(
         server_params = StdioServerParameters(
             command=server_config['command'],
             args=server_config.get('args', []),
-            env=env
+            env=env,
+            cwd=server_config.get('cwd', None)
         )
 
         # Initialize stdio client and register it with exit stack for cleanup
+        # NOTE: Why the key name `stderr` for `server_config` was chosen:
+        # Unlike the TypeScript SDK's `StdioServerParameters`, the Python SDK's
+        # `StdioServerParameters` doesn't include `stderr`.
+        # Instead, it calls `stdio_client()` with a separate argument
+        # `errlog`.  I once thought of using `errlog` for the key for the
+        # Pyhton version, but decided to follow the TypeScript version since
+        # its public API already exposes the key name and I choose consistency.
         stdio_transport = await exit_stack.enter_async_context(
-            stdio_client(server_params)
+            stdio_client(
+                server_params,
+                errlog=server_config.get('stderr', None)
+            )
         )
     except Exception as e:
         logger.error(f'Error spawning MCP server: {str(e)}')
@@ -247,13 +258,22 @@ async def get_mcp_server_tools(
     return langchain_tools
 
 
+# A very simple pre-configured logger for fallback
+def init_logger() -> logging.Logger:
+    logging.basicConfig(
+        level=logging.INFO,  # logging.DEBUG,
+        format='\x1b[90m[%(levelname)s]\x1b[0m %(message)s'
+    )
+    return logging.getLogger()
+
+
 # Type hint for cleanup function
 McpServerCleanupFn = Callable[[], Awaitable[None]]
 
 
 async def convert_mcp_to_langchain_tools(
     server_configs: Dict[str, Dict[str, Any]],
-    logger: logging.Logger = logging.getLogger(__name__)
+    logger: Optional[logging.Logger] = None
 ) -> Tuple[List[BaseTool], McpServerCleanupFn]:
     """Initialize multiple MCP servers and convert their tools to
     LangChain format.
@@ -267,7 +287,8 @@ async def convert_mcp_to_langchain_tools(
             configurations, where each configuration contains command, args,
             and env settings
         logger: Logger instance to use for logging events and errors.
-               Defaults to module logger.
+           If None, uses module logger with fallback to a pre-configured
+           logger when no root handlers exist.
 
     Returns:
         A tuple containing:
@@ -277,14 +298,25 @@ async def convert_mcp_to_langchain_tools(
 
     Example:
         server_configs = {
-            "server1": {"command": "npm", "args": ["start"]},
-            "server2": {"command": "./server", "args": ["-p", "8000"]}
+            'fetch': {
+                'command': 'uvx', 'args': ['mcp-server-fetch']
+            },
+            'weather': {
+                'command': 'npx', 'args': ['-y','@h1deya/mcp-server-weather']
+            }
         }
         tools, cleanup = await convert_mcp_to_langchain_tools(server_configs)
         # Use tools...
         await cleanup()
     """
 
+    if logger is None:
+        logger = logging.getLogger(__name__)
+        # Check if the root logger has handlers configured
+        if not logging.root.handlers and not logger.handlers:
+            # No logging configured, use a simple pre-configured logger
+            logger = init_logger()
+
     # Initialize AsyncExitStack for managing multiple server lifecycles
     stdio_transports: List[StdioTransport] = []
     async_exit_stack = AsyncExitStack()

{langchain_mcp_tools-0.1.9.dist-info → langchain_mcp_tools-0.1.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: langchain-mcp-tools
-Version: 0.1.9
+Version: 0.1.11
 Summary: Model Context Protocol (MCP) To LangChain Tools Conversion Utility
 Project-URL: Bug Tracker, https://github.com/hideya/langchain-mcp-tools-py/issues
 Project-URL: Source Code, https://github.com/hideya/langchain-mcp-tools-py
@@ -10,9 +10,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: jsonschema-pydantic>=0.6
 Requires-Dist: langchain>=0.3.14
-Requires-Dist: mcp>=1.2.0
+Requires-Dist: mcp>=1.6.0
 Requires-Dist: pyjson5>=1.6.8
-Requires-Dist: python-dotenv>=1.0.1
 Provides-Extra: dev
 Requires-Dist: dotenv>=0.9.9; extra == "dev"
 Requires-Dist: langchain-anthropic>=0.3.1; extra == "dev"
@@ -21,6 +20,7 @@ Requires-Dist: langchain-openai>=0.3.0; extra == "dev"
 Requires-Dist: langgraph>=0.2.62; extra == "dev"
 Requires-Dist: pytest>=8.3.4; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.25.2; extra == "dev"
+Dynamic: license-file
 
 # MCP To LangChain Tools Conversion Utility [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/hideya/langchain-mcp-tools-py/blob/main/LICENSE) [![pypi version](https://img.shields.io/pypi/v/langchain-mcp-tools.svg)](https://pypi.org/project/langchain-mcp-tools/)
 
@@ -35,21 +35,20 @@ dramatically expands LLM’s scope
 by enabling external tool and resource integration, including
 Google Drive, Slack, Notion, Spotify, Docker, PostgreSQL, and more…
 
-Over 1500 functional components available as MCP servers:
+Over 2000 functional components available as MCP servers:
 
-- [Glama’s list of Open-Source MCP servers](https://glama.ai/mcp/servers)
+- [MCP Server Listing on the Official Site](https://github.com/modelcontextprotocol/servers?tab=readme-ov-file#model-context-protocol-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)
-- [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.
+The goal of this utility is to make these 2000+ MCP servers readily accessible from LangChain.
 
 It contains a utility function `convert_mcp_to_langchain_tools()`.  
 This async function handles parallel initialization of specified multiple MCP servers
 and converts their available tools into a list of LangChain-compatible tools.
 
 For detailed information on how to use this library, please refer to the following document:
-- ["Supercharging LangChain: Integrating 1500+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-1500-mcp-with-react-d4e467cbf41a)
+- ["Supercharging LangChain: Integrating 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 A typescript equivalent of this utility is available
 [here](https://www.npmjs.com/package/@h1deya/langchain-mcp-tools)
@@ -73,7 +72,7 @@ but only the contents of the `mcpServers` property,
 and is expressed as a `dict`, e.g.:
 
 ```python
-mcp_configs = {
+mcp_servers = {
     'filesystem': {
         'command': 'npx',
         'args': ['-y', '@modelcontextprotocol/server-filesystem', '.']
@@ -85,7 +84,7 @@ mcp_configs = {
 }
 
 tools, cleanup = await convert_mcp_to_langchain_tools(
-    mcp_configs
+    mcp_servers
 )
 ```
 
@@ -120,12 +119,16 @@ For hands-on experimentation with MCP server integration,
 try [this LangChain application built with the utility](https://github.com/hideya/mcp-client-langchain-py)
 
 For detailed information on how to use this library, please refer to the following document:  
-["Supercharging LangChain: Integrating 1500+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-1500-mcp-with-react-d4e467cbf41a)
+["Supercharging LangChain: Integrating 2000+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 ## Limitations
 
 Currently, only text results of tool calls are supported.
 
+Remote MCP server access is not supported.
+
+Optiional MCP client Features, Roots and Sampling, are not supported.
+
 ## Change Log
 
 Can be found [here](https://github.com/hideya/langchain-mcp-tools-py/blob/main/CHANGELOG.md)

langchain_mcp_tools-0.1.11.dist-info/RECORD

@@ -0,0 +1,8 @@
+langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
+langchain_mcp_tools/langchain_mcp_tools.py,sha256=O6TxRRuS-uTOY08-WVKK86Dxx7-dCeFZZRLpBYaPIng,13577
+langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_mcp_tools-0.1.11.dist-info/licenses/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
+langchain_mcp_tools-0.1.11.dist-info/METADATA,sha256=lW4Mm8snEac1hYSuS0szfHmJZFBs79GAEo0bwyEW_sw,5212
+langchain_mcp_tools-0.1.11.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+langchain_mcp_tools-0.1.11.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
+langchain_mcp_tools-0.1.11.dist-info/RECORD,,

{langchain_mcp_tools-0.1.9.dist-info → langchain_mcp_tools-0.1.11.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (76.1.0)
+Generator: setuptools (78.1.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

langchain_mcp_tools-0.1.9.dist-info/RECORD

@@ -1,8 +0,0 @@
-langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
-langchain_mcp_tools/langchain_mcp_tools.py,sha256=0uKhEeaMLPTHvsLVMrs18MuVz1SxSQZmTE0y8NYbs5o,12221
-langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain_mcp_tools-0.1.9.dist-info/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
-langchain_mcp_tools-0.1.9.dist-info/METADATA,sha256=7-GqU1Lt_iTfkY0Jn-OmKhcBTMseNx_DlRwTlZNmhbY,5150
-langchain_mcp_tools-0.1.9.dist-info/WHEEL,sha256=beeZ86-EfXScwlR_HKu4SllMC9wUEj_8Z_4FJ3egI2w,91
-langchain_mcp_tools-0.1.9.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
-langchain_mcp_tools-0.1.9.dist-info/RECORD,,