Agents-MCP-Hackathon/Python-Code-to-Diagram-Generator-MCP

1# 🚀 Quick Start Guide2 3## Getting Started in 3 Steps4 5### Step 1: Test Your Setup6```bash7python test_setup.py8```9This will verify all dependencies are working correctly.10 11### Step 2: Start the Application12 13**Option A: Use the batch file (Windows)**14```bash15run.bat16```17 18**Option B: Manual start**19```bash20# Activate virtual environment21venv\Scripts\activate  # Windows22# or23source venv/bin/activate  # Linux/Mac24 25# Run the app26python app.py27```28 29### Step 3: Access the Application30- **Web Interface**: http://127.0.0.1:786031- **MCP Endpoint**: http://127.0.0.1:7860/gradio_api/mcp/sse32 33## Claude Desktop Integration34 35### Prerequisites361. Install Node.js from https://nodejs.org372. Install mcp-remote:38   ```bash39   npm install -g mcp-remote40   ```41 42### Configuration431. **Find your Claude Desktop config file:**44   - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`45   - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`46 472. **Copy the contents of `claude_config.json` to your Claude config file**48 493. **Restart Claude Desktop**50 51### Testing Claude Integration52In Claude Desktop, try these prompts:53 54```55Generate a UML diagram for this Python code:56 57class Vehicle:58    def __init__(self, brand):59        self.brand = brand60    61    def start(self):62        pass63 64class Car(Vehicle):65    def start(self):66        return "Engine started"67```68 69or70 71```72Analyze the structure of this Python code:73 74class Calculator:75    def add(self, a, b):76        return a + b77    78    def multiply(self, a, b):79        return a * b80```81 82## Troubleshooting83 84### Common Issues85 861. **Import errors when running test_setup.py:**87   ```bash88   pip install -r requirements.txt89   ```90 912. **Claude Desktop doesn't recognize the MCP server:**92   - Check Node.js installation: `node --version`93   - Check mcp-remote installation: `npx mcp-remote --version`94   - Verify the app is running: visit http://127.0.0.1:786095   - Restart Claude Desktop after config changes96 973. **No diagram generated:**98   - Ensure your Python code contains class definitions99   - Check for syntax errors in your code100   - Verify internet connection (PlantUML service)101 102### Debug Commands103 104```bash105# Check if the app is running106curl http://127.0.0.1:7860/gradio_api/mcp/schema107 108# Test MCP endpoint109npx mcp-remote http://127.0.0.1:7860/gradio_api/mcp/sse --transport sse-only110```111 112## Next Steps113 1141. Try the sample code in the web interface1152. Experiment with your own Python classes1163. Test the MCP integration with Claude Desktop1174. Explore the code analysis features118 119Happy diagramming! 🎨120