Add MCP Inspector support and enhance server functionality

- Updated Makefile to include a new 'inspector' command for running the MCP Inspector.
- Added instructions for using the MCP Inspector in README.md.
- Introduced a new script (run-inspector.py) to facilitate running the MCP server for the inspector.
- Refactored server.py to improve structure and added new random generation tools.
- Updated pyproject.toml to include fastmcp as a dependency.
- Enhanced test_server.py to accommodate changes in server output handling.

Author: ckaraca

Makefile

@@ -1,4 +1,4 @@
-.PHONY: help install install-dev test format lint typecheck quality build clean publish publish-test docker docker-test bump-patch bump-minor bump-major
+.PHONY: help install install-dev test format lint typecheck quality build clean publish publish-test docker docker-test bump-patch bump-minor bump-major inspector
 
 help:
 	@echo "Available commands:"
@@ -15,6 +15,7 @@ help:
 	@echo "  publish-test  Publish to Test PyPI"
 	@echo "  docker        Build Docker image"
 	@echo "  docker-test   Run tests in Docker"
+	@echo "  inspector     Run MCP Inspector"
 	@echo "  bump-patch    Bump patch version"
 	@echo "  bump-minor    Bump minor version"
 	@echo "  bump-major    Bump major version"
@@ -82,4 +83,11 @@ docker-minimal:
 	docker build -f Dockerfile.minimal -t pluggedin-random-number-generator-mcp-python:minimal .
 
 docker-smithery:
-	docker build -f Dockerfile.smithery -t pluggedin-random-number-generator-mcp-python:smithery .
+	docker build -f Dockerfile.smithery -t pluggedin-random-number-generator-mcp-python:smithery .
+
+# MCP Inspector
+inspector:
+	@echo "Starting MCP Inspector for Python server..."
+	@echo "Server will be available at http://localhost:5173"
+	@echo "Note: Make sure you have @modelcontextprotocol/inspector installed (npm install -g @modelcontextprotocol/inspector)"
+	npx @modelcontextprotocol/inspector python3 scripts/run-inspector.py

README.md

@@ -387,6 +387,24 @@ docker-compose --profile test up
 docker-compose --profile dev up
 ```
 
+### Using MCP Inspector
+
+The MCP Inspector provides a web interface to interact with and test the server:
+
+```bash
+# Install MCP Inspector (if not already installed)
+npm install -g @modelcontextprotocol/inspector
+
+# Run inspector with the Python server
+make inspector
+```
+
+The inspector will start on `http://localhost:5173` where you can:
+- View available tools and prompts
+- Test tool execution with different parameters
+- Inspect request/response payloads
+- Debug server behavior
+
 ## 🤝 Contributing
 
 Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

pyproject.toml

@@ -16,16 +16,16 @@ classifiers = [
     "Topic :: Software Development :: Libraries",
 ]
 keywords = ["mcp", "model-context-protocol", "random", "cryptography", "rng", "prng", "csprng", "ai", "llm", "python"]
+dependencies = [
+    "fastmcp>=0.1.0",
+]
 
 [project.urls]
 "Homepage" = "https://github.com/VeriTeknik/pluggedin-random-number-generator-mcp-python"
 "Bug Tracker" = "https://github.com/VeriTeknik/pluggedin-random-number-generator-mcp-python/issues"
 "Repository" = "https://github.com/VeriTeknik/pluggedin-random-number-generator-mcp-python"
 "Documentation" = "https://github.com/VeriTeknik/pluggedin-random-number-generator-mcp-python#readme"
 
-[project.dependencies]
-fastmcp = ">=0.1.0"
-
 [project.scripts]
 pluggedin-random-number-generator-mcp-python = "pluggedin_random_number_generator_mcp.server:main"
 

scripts/run-inspector.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+"""Simple wrapper to run the MCP server for the inspector."""
+import os
+import sys
+
+os.environ["MCP_NO_BANNER"] = "1"
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "src"))
+
+from pluggedin_random_number_generator_mcp.server import main
+main()

src/pluggedin_random_number_generator_mcp/__main__.py

@@ -0,0 +1,5 @@
+"""Entry point for running the module with python -m"""
+from .server import main
+
+if __name__ == "__main__":
+    main()