langchain-mcp-tools 0.1.4__py3-none-any.whl → 0.1.6__py3-none-any.whl

langchain_mcp_tools/langchain_mcp_tools.py

@@ -14,6 +14,7 @@ from typing import (
     Dict,
     List,
     NoReturn,
+    Optional,
     Tuple,
     Type,
     TypeAlias,
@@ -27,7 +28,7 @@ try:
     from mcp.client.stdio import stdio_client
     import mcp.types as mcp_types
     from pydantic import BaseModel
-    from pympler import asizeof
+    # from pydantic_core import to_json
 except ImportError as e:
     print(f'\nError: Required package not found: {e}')
     print('Please ensure all required packages are installed\n')
@@ -143,6 +144,7 @@ async def get_mcp_server_tools(
         # Wrap MCP tools into LangChain tools
         langchain_tools: List[BaseTool] = []
         for tool in tools_response.tools:
+
             # Define adapter class to convert MCP tool to LangChain format
             class McpToLangChainAdapter(BaseTool):
                 name: str = tool.name or 'NO NAME'
@@ -151,10 +153,11 @@ async def get_mcp_server_tools(
                 args_schema: Type[BaseModel] = jsonschema_to_pydantic(
                     tool.inputSchema
                 )
+                session: Optional[ClientSession] = None
 
                 def _run(self, **kwargs: Any) -> NoReturn:
                     raise NotImplementedError(
-                        'Only async operation is supported'
+                        'MCP tools only support async operations'
                     )
 
                 async def _arun(self, **kwargs: Any) -> Any:
@@ -162,17 +165,62 @@ async def get_mcp_server_tools(
                     Asynchronously executes the tool with given arguments.
                     Logs input/output and handles errors.
                     """
-                    logger.info(f'MCP tool "{server_name}"/"{tool.name}"'
-                                f' received input: {kwargs}')
-                    result = await session.call_tool(self.name, kwargs)
-                    if result.isError:
-                        raise ToolException(result.content)
-
-                    # Log result size for monitoring
-                    size = asizeof.asizeof(result.content)
                     logger.info(f'MCP tool "{server_name}"/"{tool.name}" '
-                                f'received result (size: {size})')
-                    return result.content
+                                f'received input: {kwargs}')
+
+                    try:
+                        result = await session.call_tool(self.name, kwargs)
+
+                        if hasattr(result, 'isError') and result.isError:
+                            raise ToolException(
+                                f'Tool execution failed: {result.content}'
+                            )
+
+                        if not hasattr(result, 'content'):
+                            return str(result)
+
+                        # The return type of `BaseTool`'s `arun` is `str`.
+                        try:
+                            result_content_text = '\n\n'.join(
+                                item.text
+                                for item in result.content
+                                if isinstance(item, mcp_types.TextContent)
+                            )
+                            # text_items = [
+                            #     item
+                            #     for item in result.content
+                            #     if isinstance(item, mcp_types.TextContent)
+                            # ]
+                            # result_content_text =to_json(text_items).decode()
+
+                        except KeyError as e:
+                            result_content_text = (
+                                f'Error in parsing result.content: {str(e)}; '
+                                f'contents: {repr(result.content)}'
+                            )
+
+                        # Log rough result size for monitoring
+                        size = len(result_content_text.encode())
+                        logger.info(f'MCP tool "{server_name}"/"{tool.name}" '
+                                    f'received result (size: {size})')
+
+                        # If no text content, return a clear message
+                        # describing the situation.
+                        result_content_text = (
+                            result_content_text or
+                            'No text content available in response'
+                        )
+
+                        return result_content_text
+
+                    except Exception as e:
+                        logger.warn(
+                            f'MCP tool "{server_name}"/"{tool.name}" '
+                            f'caused error:  {str(e)}'
+                        )
+                        if self.handle_tool_error:
+                            return f'Error executing MCP tool: {str(e)}'
+                        raise
 
             langchain_tools.append(McpToLangChainAdapter())
 

{langchain_mcp_tools-0.1.4.dist-info → langchain_mcp_tools-0.1.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: langchain-mcp-tools
-Version: 0.1.4
+Version: 0.1.6
 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
@@ -16,7 +16,6 @@ Requires-Dist: langchain-openai>=0.3.0
 Requires-Dist: langgraph>=0.2.62
 Requires-Dist: mcp>=1.2.0
 Requires-Dist: pyjson5>=1.6.8
-Requires-Dist: pympler>=1.1
 Requires-Dist: python-dotenv>=1.0.1
 Provides-Extra: dev
 Requires-Dist: pytest>=8.3.4; extra == "dev"
@@ -29,35 +28,32 @@ This package is intended to simplify the use of
 server tools with LangChain / Python.
 
 [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 `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 450+ 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)
 
-## Requirements
+## Prerequisites
 
 - Python 3.11+
 
@@ -105,7 +101,7 @@ The returned tools can be used with LangChain, e.g.:
 ```python
 # from langchain.chat_models import init_chat_model
 llm = init_chat_model(
-    model='claude-3-5-haiku-latest',
+    model='claude-3-5-sonnet-latest',
     model_provider='anthropic'
 )
 
@@ -115,12 +111,15 @@ agent = create_react_agent(
     tools
 )
 ```
-A simple and experimentable usage example can be found
+
+Find complete, minimal working usage examples
 [here](https://github.com/hideya/langchain-mcp-tools-py-usage/blob/main/src/example.py)
 
-A more realistic usage example can be found
-[here](https://github.com/hideya/mcp-client-langchain-py)
+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 450+ MCP with ReAct"](https://medium.com/@h1deya/supercharging-langchain-integrating-450-mcp-with-react-d4e467cbf41a)
 
 ## Limitations
 

langchain_mcp_tools-0.1.6.dist-info/RECORD

@@ -0,0 +1,8 @@
+langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
+langchain_mcp_tools/langchain_mcp_tools.py,sha256=WY1ckLyIMbRIVhsECEFdAY6DnZB2Q3BLH-Nrb727M-o,11699
+langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_mcp_tools-0.1.6.dist-info/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
+langchain_mcp_tools-0.1.6.dist-info/METADATA,sha256=yUpYI9tc-JYxN15UzHGTpe9KeQbVT9NhRhUy6MJIqaY,4926
+langchain_mcp_tools-0.1.6.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+langchain_mcp_tools-0.1.6.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
+langchain_mcp_tools-0.1.6.dist-info/RECORD,,

langchain_mcp_tools-0.1.4.dist-info/RECORD

@@ -1,8 +0,0 @@
-langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
-langchain_mcp_tools/langchain_mcp_tools.py,sha256=-kzxOhYUaieWngSSYk0kUZw6SeBNmxjnXm6Ed2rStz8,9627
-langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain_mcp_tools-0.1.4.dist-info/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
-langchain_mcp_tools-0.1.4.dist-info/METADATA,sha256=-JPzwr4567fPMFq9caElQjQ2BorchdeXyf_TDje-bwo,4794
-langchain_mcp_tools-0.1.4.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-langchain_mcp_tools-0.1.4.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
-langchain_mcp_tools-0.1.4.dist-info/RECORD,,