MCP Client
- agent-framework
A sample code to use Model Context Protocol with Claude APIs
About
What is MCP Client?
MCP Client is a command-line application that connects to Model Context Protocol (MCP) servers, allowing Claude to discover and use tools provided by those servers. It requires Python 3.11 or higher and an Anthropic API key, and is intended for developers building tool-augmented workflows.
How to use MCP Client?
Clone the repository, install the dependencies (anthropic, mcp, python-dotenv) using pip or uv, and set your ANTHROPIC_API_KEY in a .env file. Then run the client with python client.py path/to/server_script.py (or .js for JavaScript servers).
Key features of MCP Client
- Interactive command-line interface
- Support for both Python and Node.js MCP servers
- Seamless integration with Claude’s tool-use capabilities
- Proper resource management and error handling
- Automated tool discovery and execution through the MCP protocol
Use cases of MCP Client
- Expose custom scripts or APIs as tools for Claude to use during conversations
- Build automated workflows where Claude orchestrates multiple external services
- Rapidly prototype and test MCP servers locally before deploying them
- Enable Claude to perform file operations, database queries, or other server-side actions
FAQ from MCP Client
What is an MCP server?
An MCP server is a program that exposes tools via the Model Context Protocol. MCP Client connects to such servers and lets Claude invoke those tools as part of its reasoning process.
What AI models does MCP Client support?
MCP Client works with Anthropic’s Claude through the Anthropic API. Other models are not supported out of the box.
Can I use JavaScript MCP servers?
Yes. The client accepts both .py and .js server scripts, so you can use Node.js-based MCP servers.
How long does the first response take?
The first response may take up to 30 seconds due to initialization. Subsequent requests are typically faster.
Do I need an API key to use MCP Client?
Yes, you must provide a valid Anthropic API key in a .env file. The client will not operate without it.
Details
- Author
- alessandrodorazio
- GitHub stars
- 1
- Category
- agent-framework
- Repository
- alessandrodorazio/mcp-client-server
MCP Client
This is a Model Context Protocol (MCP) client that allows you to interact with MCP servers, enabling Claude to use tools provided by these servers.
Prerequisites
- Python 3.11 or higher
- An Anthropic API key (set in .env file)
Setup
1. Clone this repository
2. Ensure you have the required dependencies installed:
pip install anthropic mcp python-dotenv
Or use uv:
uv pip install anthropic mcp python-dotenv
3. Set up your Anthropic API key in a .env file:
ANTHROPIC_API_KEY=your_api_key_here
Usage
Run the client by providing the path to an MCP server script:
python client.py path/to/server_script.py
The client supports both Python and JavaScript MCP servers:
python client.py path/to/server_script.js
How It Works
1. The client connects to the specified MCP server
2. It retrieves available tools from the server
3. When you enter a query, it's sent to Claude along with tool descriptions
4. Claude decides which tools to use
5. The client executes tool calls through the server
6. Results are sent back to Claude for a final response
Features
- Interactive command-line interface
- Support for both Python and Node.js MCP servers
- Proper resource management and error handling
- Seamless integration with Claude's tool-use capabilities
Troubleshooting
- If you encounter connection issues, verify the server path and ensure the server is running
- The first response might take up to 30 seconds due to initialization
- For more detailed logs, check the server output
Resources
- Model Context Protocol Documentation
- Anthropic API Documentation