A simple command-line MCP (Model Context Protocol) client built with Python and the Anthropic API. It connects to any MCP server, discovers its available tools, and lets Claude use them to answer your queries.
-
Install dependencies:
uv sync -
Create a
.envfile in this folder:ANTHROPIC_API_KEY=your-api-key-here
Run the client, pointing it at any MCP server script:
uv run client.py path/to/server.py
Example (connecting to the companion weather-mcp-server):
uv run client.py ../weather/weather.py
Then type natural-language queries at the prompt. Claude will call the server's tools as needed to answer.
- Python (see
.python-version) - An Anthropic API key with available credits
MIT
<img width="1892" height="697" alt="Screenshot 2026-08-23 192133" src="https://github.com/user-attachments/assets/4e97a42f-3478-4caf-a3b9-e588d38c1db1" />