langchain-mcp-tools 0.1.10__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,7 +258,7 @@ async def get_mcp_server_tools(
     return langchain_tools
 
 
-# A very simple pre-implemented logger for fallback
+# A very simple pre-configured logger for fallback
 def init_logger() -> logging.Logger:
     logging.basicConfig(
         level=logging.INFO,  # logging.DEBUG,
@@ -287,8 +298,12 @@ 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...
@@ -299,7 +314,7 @@ async def convert_mcp_to_langchain_tools(
         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 our pre-implemented logger
+            # No logging configured, use a simple pre-configured logger
             logger = init_logger()
 
     # Initialize AsyncExitStack for managing multiple server lifecycles

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langchain-mcp-tools
-Version: 0.1.10
+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,7 +10,7 @@ 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
 Provides-Extra: dev
 Requires-Dist: dotenv>=0.9.9; extra == "dev"
@@ -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:
 
+- [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/)
-- [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.
+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.10.dist-info → langchain_mcp_tools-0.1.11.dist-info}/WHEEL

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

langchain_mcp_tools-0.1.10.dist-info/RECORD

@@ -1,8 +0,0 @@
-langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
-langchain_mcp_tools/langchain_mcp_tools.py,sha256=vIiOB8u62Q-7Mi8U6XI247g-xfxpE2QvoBeo0pbtFX4,12838
-langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain_mcp_tools-0.1.10.dist-info/licenses/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
-langchain_mcp_tools-0.1.10.dist-info/METADATA,sha256=kAMCbY0YTAA5aj-SaiGqtAanX30ggpEeZO39zChua0Y,5135
-langchain_mcp_tools-0.1.10.dist-info/WHEEL,sha256=DK49LOLCYiurdXXOXwGJm6U4DkHkg4lcxjhqwRa0CP4,91
-langchain_mcp_tools-0.1.10.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
-langchain_mcp_tools-0.1.10.dist-info/RECORD,,