MCP Client

MCP Client

By alessandrodorazio GitHub

A sample code to use Model Context Protocol with Claude APIs

Overview

what is MCP Client?

MCP Client is a sample code that demonstrates how to use the Model Context Protocol (MCP) with Claude APIs, allowing interaction with MCP servers.

how to use MCP Client?

To use MCP Client, clone the repository, install the required dependencies, set up your Anthropic API key in a .env file, and run the client by providing the path to an MCP server script.

key features of MCP Client?

  • 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

use cases of MCP Client?

  1. Interacting with various MCP servers to utilize their tools.
  2. Running Python or JavaScript scripts that implement the MCP.
  3. Testing and developing applications that leverage Claude's capabilities through MCP.

FAQ from MCP Client?

  • What are the prerequisites for using MCP Client?

You need Python 3.11 or higher and an Anthropic API key.

  • How do I run the MCP Client?

Use the command python client.py path/to/server_script.py or python client.py path/to/server_script.js.

  • What should I do if I encounter connection issues?

Verify the server path and ensure the server is running.

Content

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

No tools information available.
No content found.