Improve all readmes (#188)

* Improve all readmes

* Address some of the comments

mcp-client-python/README.md

@@ -1,6 +1,41 @@
 # An LLM-Powered Chatbot MCP Client written in Python
 
-See the [Build an MCP client](https://modelcontextprotocol.io/docs/develop/build-client) tutorial for more information.
+An interactive chatbot MCP client: it launches an MCP server over stdio, lists its tools, and hands them to Claude, which can call them while answering your questions.
+
+This example accompanies the [Build an MCP client](https://modelcontextprotocol.io/docs/develop/build-client) tutorial.
+
+## Prerequisites
+
+- Python 3.10+
+- [uv](https://docs.astral.sh/uv/)
+- An [Anthropic API key](https://console.anthropic.com/) (optional — see below)
+
+## Setup
+
+Put your API key in a `.env` file (or export `ANTHROPIC_API_KEY` in your shell):
+
+```bash
+cp .env.example .env
+# then edit .env and add your key
+```
+
+## Run the client
+
+Pass the path to a server script. `.py` servers are launched with `uv`, `.js` servers with `node`:
+
+```bash
+uv run client.py ../weather-server-python/weather.py
+```
+
+or, against the TypeScript server (build it first — see its README):
+
+```bash
+uv run client.py ../weather-server-typescript/build/index.js
+```
+
+Type a question (for example, "What's the weather in Sacramento?") and Claude answers using the server's tools. Type `quit` to exit.
+
+Without an `ANTHROPIC_API_KEY`, the client still connects, prints the server's tools, and exits — useful for verifying the MCP wiring without credentials.
 
 ## Structured content