Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions tests/test_mcp_client_multiple.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
import asyncio
import pytest
from tinyagent.mcp_client import MCPClient
@pytest.mark.asyncio
async def test_multiple_clients():
clients = [MCPClient() for _ in range(3)]
await asyncio.gather(*(client.connect("python", ["-m", "mcp.examples.echo_server"]) for client in clients))
results = await asyncio.gather(*(client.call_tool("echo", {"message": f"Hello {i}"}) for i, client in enumerate(clients)))
for i, result in enumerate(results):
assert result == f"Hello {i}"
await asyncio.gather(*(client.close() for client in clients))
180 changes: 23 additions & 157 deletions tinyagent/mcp_client.py
Original file line number Diff line number Diff line change
@@ -1,162 +1,28 @@
import warnings
import asyncio
import json
import logging
from typing import Dict, List, Optional, Any, Tuple, Callable

# Keep your MCPClient implementation unchanged
import asyncio
from contextlib import AsyncExitStack

# MCP core imports
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

# Set up logging
logger = logging.getLogger(__name__)

class MCPClient:
def __init__(self, logger: Optional[logging.Logger] = None):
self.session = None
self.exit_stack = AsyncExitStack()
self.logger = logger or logging.getLogger(__name__)

# Simplified callback system
self.callbacks: List[callable] = []

self.logger.debug("MCPClient initialized")

def add_callback(self, callback: callable) -> None:
"""
Add a callback function to the client.

Args:
callback: A function that accepts (event_name, client, **kwargs)
"""
self.callbacks.append(callback)

async def _run_callbacks(self, event_name: str, **kwargs) -> None:
"""
Run all registered callbacks for an event.

Args:
event_name: The name of the event
**kwargs: Additional data for the event
"""
for callback in self.callbacks:
try:
logger.debug(f"Running callback: {callback}")
if asyncio.iscoroutinefunction(callback):
logger.debug(f"Callback is a coroutine function")
await callback(event_name, self, **kwargs)
else:
# Check if the callback is a class with an async __call__ method
if hasattr(callback, '__call__') and asyncio.iscoroutinefunction(callback.__call__):
logger.debug(f"Callback is a class with an async __call__ method")
await callback(event_name, self, **kwargs)
else:
logger.debug(f"Callback is a regular function")
callback(event_name, self, **kwargs)
except Exception as e:
logger.error(f"Error in callback for {event_name}: {str(e)}")

async def connect(self, command: str, args: list[str]):
"""
Launches the MCP server subprocess and initializes the client session.
:param command: e.g. "python" or "node"
:param args: list of args to pass, e.g. ["my_server.py"] or ["build/index.js"]
"""
# Prepare stdio transport parameters
params = StdioServerParameters(command=command, args=args)
# Open the stdio client transport
self.stdio, self.sock_write = await self.exit_stack.enter_async_context(
stdio_client(params)
)
# Create and initialize the MCP client session
self.session = await self.exit_stack.enter_async_context(
ClientSession(self.stdio, self.sock_write)
)
await self.session.initialize()

async def list_tools(self):
resp = await self.session.list_tools()
print("Available tools:")
for tool in resp.tools:
print(f" • {tool.name}: {tool.description}")

async def call_tool(self, name: str, arguments: dict):
"""
Invokes a named tool and returns its raw content list.
"""
# Notify tool start
await self._run_callbacks("tool_start", tool_name=name, arguments=arguments)

try:
resp = await self.session.call_tool(name, arguments)

# Notify tool end
await self._run_callbacks("tool_end", tool_name=name, arguments=arguments,
result=resp.content, success=True)

return resp.content
except Exception as e:
# Notify tool end with error
await self._run_callbacks("tool_end", tool_name=name, arguments=arguments,
error=str(e), success=False)
raise

async def close(self):
"""Clean up subprocess and streams."""
if self.exit_stack:
try:
await self.exit_stack.aclose()
except (RuntimeError, asyncio.CancelledError) as e:
# Log the error but don't re-raise it
self.logger.error(f"Error during client cleanup: {e}")
finally:
# Always reset these regardless of success or failure
self.session = None
self.exit_stack = AsyncExitStack()

async def run_example():
"""Example usage of MCPClient with proper logging."""
import sys
from tinyagent.hooks.logging_manager import LoggingManager

# Create and configure logging manager
log_manager = LoggingManager(default_level=logging.INFO)
log_manager.set_levels({
'tinyagent.mcp_client': logging.DEBUG, # Debug for this module
'tinyagent.tiny_agent': logging.INFO,
})

# Configure a console handler
console_handler = logging.StreamHandler(sys.stdout)
log_manager.configure_handler(
console_handler,
format_string='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
level=logging.DEBUG
from types import TracebackType
from typing import Any, Optional, List, Union, Tuple
from smolagents.tools import Tool
try:
from mcpadapt.core import MCPAdapt
from mcpadapt.smolagents_adapter import SmolAgentsAdapter
except ModuleNotFoundError:
raise ModuleNotFoundError(
"Please install 'mcp' extra to use MCPClient: `pip install 'tinyagent[mcp]'`"
)

# Get module-specific logger
mcp_logger = log_manager.get_logger('tinyagent.mcp_client')

mcp_logger.debug("Starting MCPClient example")

# Create client with our logger
client = MCPClient(logger=mcp_logger)

try:
# Connect to a simple echo server
from mcp.client.stdio import StdioServerParameters
class MCPClient:
"""
Manages the connection to one or multiple MCP servers and makes its tools available to TinyAgent.
Example:
client = MCPClient()
await client.connect("python", ["-m", "mcp.examples.echo_server"])

# List available tools
await client.list_tools()

# Call the echo tool
result = await client.call_tool("echo", {"message": "Hello, MCP!"})
mcp_logger.info(f"Echo result: {result}")

finally:
# Clean up
result = await client.call_tool("echo", {"message": "Hello"})
await client.close()
mcp_logger.debug("Example completed")
"""
def __init__(self, logger: Optional[logging.Logger] = None):
self._adapter = None
self._tools: Optional[List[Tool]] = None
self.logger = logger or logging.getLogger(__name__)
self.logger.debug("MCPClient initialized (smolagents-based)")