fix: cleanup of examples and Readme

Author: constantinius

test-mcp/README.md

@@ -71,33 +71,40 @@ uv sync
 
 ### FastMCP Library Server (HTTP)
 ```bash
-# Using the script
+# Using the script (automatically starts MCP inspector)
 ./run_fastmcp.sh
 
-# Or directly
+# Or directly (just the server, no inspector)
 uv run python main_fastmcp.py
 ```
 
-This starts an HTTP server on `http://127.0.0.1:8000` that you can interact with via HTTP requests.
+This starts an HTTP server on `http://127.0.0.1:8000` that you can interact with via HTTP requests. The `run_fastmcp.sh` script automatically starts the MCP inspector tool for testing.
 
 ### MCP Built-in FastMCP Server (STDIO)
 ```bash
-# Using the script
+# Using the script (automatically starts MCP inspector)
 ./run.sh
 
-# Or directly
+# Or directly (just the server, no inspector)
 uv run python main.py
 ```
 
+The `run.sh` script automatically starts the MCP inspector tool for testing.
+
 ### Low-Level Server (STDIO)
 ```bash
-# Using the script
+# Using the script (server only)
 ./run_lowlevel.sh
 
 # Or directly
 uv run python main_lowlevel.py
 ```
 
+**Note:** The `run_lowlevel.sh` script does NOT automatically start the MCP inspector. To test this server, you need to manually start the inspector:
+```bash
+npx @modelcontextprotocol/inspector
+```
+
 ## Using with MCP Clients
 
 The STDIO-based servers (`main.py` and `main_lowlevel.py`) can be used with any MCP-compatible client like [Claude Desktop](https://claude.ai/download).
@@ -144,15 +151,27 @@ The FastMCP Library server runs as an HTTP server and requires a different clien
 
 The [MCP Inspector](https://github.com/modelcontextprotocol/inspector) is a developer tool for testing and debugging MCP servers. It provides an interactive web interface to test your server's tools, resources, and prompts.
 
-### Installation & Usage
+### Automatic Inspector Startup
+
+The following run scripts **automatically start the MCP inspector** for you:
+- `./run.sh` (MCP Built-in FastMCP server)
+- `./run_fastmcp.sh` (FastMCP Library server)
+
+### Manual Inspector Startup
 
-The MCP Inspector can be run directly using `npx` without installation:
+For the **low-level server** (`run_lowlevel.sh`), the inspector is NOT started automatically. You need to manually start it:
 
 ```bash
+# First, start the server
+./run_lowlevel.sh
+
+# Then, in a separate terminal, start the inspector
 npx @modelcontextprotocol/inspector
 ```
 
-### Testing Each Server Implementation
+### Testing Each Server Implementation Manually
+
+If you prefer to run the inspector manually for any server:
 
 **MCP Built-in FastMCP Server (`main.py`):**
 ```bash

test-mcp/main.py

@@ -209,13 +209,3 @@ def debug_assistant_prompt() -> str:
 4. Provide prevention strategies
 
 Ask clarifying questions if needed."""
-
-
-
-# mcp.run()
-# def main():
-#     # Run the MCP server
-#     mcp.run()
-
-# if __name__ == "__main__":
-#     main()

test-mcp/run.sh

@@ -3,6 +3,5 @@
 # Install dependencies
 uv sync
 
-# Run the MCP server
-uv run python main.py
-
+# Run the MCP server + the mcp inspector
+uv run mcp dev main.py

test-mcp/run_fastmcp.sh

@@ -4,5 +4,5 @@
 uv sync
 
 # Run the MCP server
-uv run python main.py
+uv run fastmcp dev main_fastmcp.py