langchain-mcp-tools 0.1.3__py3-none-any.whl → 0.1.5__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,
@@ -64,8 +65,8 @@ async def spawn_mcp_server_and_get_transport(
         Exception: If server spawning fails
     """
     try:
-        logger.info(f'MCP server "{server_name}": initializing with:',
-                    server_config)
+        logger.info(f'MCP server "{server_name}": '
+                    f'initializing with: {server_config}')
 
         # NOTE: `uv` and `npx` seem to require PATH to be set.
         # To avoid confusion, it was decided to automatically append it
@@ -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:
@@ -163,16 +166,45 @@ async def get_mcp_server_tools(
                     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)
+                            )
+                            result_content_text = result_content_text or ''
+
+                        except KeyError as e:
+                            result_content_text = (
+                                f'Error in parsing result.content: {str(e)}; '
+                                f'contents: {repr(result.content)}'
+                            )
+
+                        # Log result size for monitoring
+                        size = asizeof.asizeof(result_content_text)
+                        logger.info(f'MCP tool "{server_name}"/"{tool.name}" '
+                                    f'received result (size: {size})')
+
+                        return result_content_text
+
+                    except Exception as e:
+                        if self.handle_tool_error:
+                            return f'Error executing MCP tool: {str(e)}'
+                        raise
 
             langchain_tools.append(McpToLangChainAdapter())
 

{langchain_mcp_tools-0.1.3.dist-info → langchain_mcp_tools-0.1.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: langchain-mcp-tools
-Version: 0.1.3
+Version: 0.1.5
 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
@@ -29,32 +29,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…
 
-- [Smithery: MCP Server Registry](https://smithery.ai/)
-- [Glama’s list of Open-Source MCP servers](https://glama.ai/mcp/servers)
+Over 450 functional components available as MCP servers:
 
-In the MCP framework, external features are encapsulated in an MCP server
-that runs in a separate process.
-This clear decoupling allows for easy adoption and reuse of
-any of the significant collections of MCP servers listed above.
+- [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)
 
-To make it easy for LangChain 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+
 
@@ -102,7 +102,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'
 )
 
@@ -112,12 +112,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.5.dist-info/RECORD

@@ -0,0 +1,8 @@
+langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
+langchain_mcp_tools/langchain_mcp_tools.py,sha256=UNvQSkj2MPV4aF1HFVLjE5AncXqw6eRLwqMuIQgefoc,10926
+langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+langchain_mcp_tools-0.1.5.dist-info/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
+langchain_mcp_tools-0.1.5.dist-info/METADATA,sha256=mlv50j7vIG3dtlmwP7qX2giU4G_T-PA5RYBWUitF-80,4954
+langchain_mcp_tools-0.1.5.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+langchain_mcp_tools-0.1.5.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
+langchain_mcp_tools-0.1.5.dist-info/RECORD,,

langchain_mcp_tools-0.1.3.dist-info/RECORD

@@ -1,8 +0,0 @@
-langchain_mcp_tools/__init__.py,sha256=Xtv2VphhrWB_KlxTIofHZqtCIGtNEl0MxugnrNXTERA,94
-langchain_mcp_tools/langchain_mcp_tools.py,sha256=hdlCAAwy7xVHzBNq-t5K91uqfieqeMXJcdr3ZoUcDGo,9621
-langchain_mcp_tools/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-langchain_mcp_tools-0.1.3.dist-info/LICENSE,sha256=CRC91e8v116gCpnp7h49oIa6_zjhxqnHFTREeoZFJwA,1072
-langchain_mcp_tools-0.1.3.dist-info/METADATA,sha256=ZQCV-DU31mUuM6tjj5ygkrRav_wpUnr1I7pzzx29P8s,4547
-langchain_mcp_tools-0.1.3.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-langchain_mcp_tools-0.1.3.dist-info/top_level.txt,sha256=aR_9V2A1Yt-Bca60KmndmGLUWb2wiM5IOG-Gkaf1dxY,20
-langchain_mcp_tools-0.1.3.dist-info/RECORD,,