import asyncio import os from contextlib import AsyncExitStack from pathlib import Path from anthropic import Anthropic from dotenv import load_dotenv from mcp import ClientSession, StdioServerParameters from mcp.client.stdio import stdio_client load_dotenv() # load environment variables from .env # Claude model constant ANTHROPIC_MODEL = "claude-sonnet-4-5" MAX_TOOL_TURNS = 10 class MCPClient: def __init__(self): # Initialize session and client objects self.session: ClientSession | None = None self.exit_stack = AsyncExitStack() self._anthropic: Anthropic | None = None @property def anthropic(self) -> Anthropic: """Lazy-initialize Anthropic client when needed""" if self._anthropic is None: self._anthropic = Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY")) return self._anthropic async def connect_to_server(self, server_script_path: str): """Connect to an MCP server Args: server_script_path: Path to the server script (.py or .js) """ is_python = server_script_path.endswith(".py") is_js = server_script_path.endswith(".js") if not (is_python or is_js): raise ValueError("Server script must be a .py or .js file") if is_python: path = Path(server_script_path).resolve() server_params = StdioServerParameters( command="uv", args=["--directory", str(path.parent), "run", path.name], env=None, ) else: server_params = StdioServerParameters(command="node", args=[server_script_path], env=None) stdio_transport = await self.exit_stack.enter_async_context(stdio_client(server_params)) self.stdio, self.write = stdio_transport self.session = await self.exit_stack.enter_async_context(ClientSession(self.stdio, self.write)) await self.session.initialize() # List available tools response = await self.session.list_tools() tools = response.tools print("\nConnected to server with tools:", [tool.name for tool in tools]) async def process_query(self, query: str) -> str: """Process a query using Claude and available tools""" messages = [{"role": "user", "content": query}] tools_response = await self.session.list_tools() available_tools = [ {"name": tool.name, "description": tool.description, "input_schema": tool.inputSchema} for tool in tools_response.tools ] final_text = [] response = self.anthropic.messages.create( model=ANTHROPIC_MODEL, max_tokens=1000, messages=messages, tools=available_tools ) for _ in range(MAX_TOOL_TURNS): tool_uses = [] for content in response.content: if content.type == "text": final_text.append(content.text) elif content.type == "tool_use": tool_uses.append(content) if not tool_uses: return "\n".join(final_text) tool_results = [] for tool_use in tool_uses: result = await self.session.call_tool(tool_use.name, tool_use.input) final_text.append(f"[Calling tool {tool_use.name} with args {tool_use.input}]") tool_results.append( { "type": "tool_result", "tool_use_id": tool_use.id, "content": result.content, } ) messages.append({"role": "assistant", "content": response.content}) messages.append({"role": "user", "content": tool_results}) response = self.anthropic.messages.create( model=ANTHROPIC_MODEL, max_tokens=1000, messages=messages, tools=available_tools, ) final_text.append(f"[Stopped after {MAX_TOOL_TURNS} tool-use turns]") return "\n".join(final_text) async def chat_loop(self): """Run an interactive chat loop""" print("\nMCP Client Started!") print("Type your queries or 'quit' to exit.") while True: try: query = input("\nQuery: ").strip() except (EOFError, KeyboardInterrupt): break if query.lower() == "quit": break try: response = await self.process_query(query) print("\n" + response) except Exception as e: print(f"\nError: {str(e)}") async def cleanup(self): """Clean up resources""" await self.exit_stack.aclose() async def main(): if len(sys.argv) < 2: print("Usage: python client.py ") sys.exit(1) client = MCPClient() try: await client.connect_to_server(sys.argv[1]) # Check if we have a valid API key to continue api_key = os.getenv("ANTHROPIC_API_KEY") if not api_key: print("\nNo ANTHROPIC_API_KEY found. To query these tools with Claude, set your API key:") print(" export ANTHROPIC_API_KEY=your-api-key-here") return await client.chat_loop() finally: await client.cleanup() if __name__ == "__main__": import sys asyncio.run(main())