Maestrobot Client

Maestrobot is a CLI-based AI agent that interacts with multiple Model Context Protocol (MCP) servers. It integrates with Spotify and Ticketmaster to provide music-related insights, event recommendations, and more!

Features

• 🛜 Connects to multiple MCP servers simultaneously
• 🛣️ Routes tool requests dynamically to the appropriate server
• 🤖 Uses Anthropic's Claude to process queries and invoke tools
• 💬 Interactive CLI-based chat interface for real-time responses

Setup

Prerequisites

Ensure you have the following installed:

• uv (used for package management)
• Python 3.13+
• An Anthropic API key (for Claude)

Note that the MCP servers have their own API requirements, which are described in their readmes. In particular, in order to use the Spotify developer API, you must have a paid Spotify account:

• Spotify MCP
• Live Events MCP

Installation

1. Clone the repository

   git clone https://github.com/mmmaaatttttt/maestrobot-client.git  
   cd maestrobot-client
   

2. Set up your environment using uv:

   uv venv  
   uv sync  
   

3. Copy the example config and update it with your local paths. Note that you can also store MCP server environment variables in the appropriate repositories, if you have them cloned locally. In this case, you can remove the "env" sections of the example server config file.

   cp server_config.example.json server_config.json  
   

   Remember to favor full paths in your config!

4. Place your Anthropic API key in a .env file that follows the conventions of the .env.example file.

Running Maestrobot

Once everything is set up, start the client with:

uv run maestrobot-client  

This will launch the interactive chat interface, allowing you to send queries and leverage MCP tools.

Resources

• Introducing the Model Context Protocol
• Model Context Protocol Documentation
• MCP Client Demo Quickstart