Repo for my four-part series on llm tools and mcp servers.
LLM Tools Real Estate Agent - Part 4: Server-Sent Events
A production-ready AI real estate agent with real-time streaming responses using Server-Sent Events (SSE). This implementation adds streaming capabilities to the secure MCP architecture from Part 3.
📍 Current Branch: part-4-sse
This is Part 4 of a 4-part series showing the evolution from a simple chatbot to a production-ready AI agent system. This part adds real-time streaming with SSE while maintaining all security features and the frontend UI at localhost:3000.
What's New in Part 4: Server-Sent Events
Building on the secure MCP architecture from Part 3, this branch adds real-time streaming capabilities:
Key Streaming Features
📡 Server-Sent Events: Real-time streaming of AI responses
💭 Thinking Indicators: Visual feedback when AI is processing vs responding
📝 Progressive Rendering: Stream responses character-by-character as generated
🔄 Auto Reconnection: Automatic retry on connection drops
⏱️ Production Timeouts: Configurable timeouts for all operations
// Different event types sent via SSE'thinking'// AI is processing (tool calls, reasoning)'content'// Streaming response content'error'// Error occurred during processing'done'// Response completed successfully
Connection Status: Visual indicators for SSE connection health
Auto Reconnect: Seamless reconnection if connection drops
Enhanced UX Flow
User sends message
Shows "Thinking..." indicator
Tool execution feedback (if applicable)
Progressive response streaming begins
Final response completion
Browser Compatibility
Uses native EventSource API
Fallback for older browsers
Automatic retry logic
Graceful degradation
Getting Started
Prerequisites
Node.js 18+
npm 9+
OpenRouter API key
Quick Setup
Clone the repository:
git clone git@github.com:lorenseanstewart/llm-tools-series.git
cd llm-tools-series
npm run install-all # Installs dependencies for all workspaces
Note: The default branch is part-4-sse which contains the complete project with Server-Sent Events implementation.
Setup environment:
There are FOUR .env files you need to update. In the three directories within the apps directory, remove the .example part of the file name .env.example.. The main-app also needs your open router key. The fourth .env file is at the root of the project and also needs you open router key.
npm run setup
Important: You need to configure THREE .env files with matching JWT_SECRET:
apps/main-app/.env - Set your OpenRouter API key and JWT_SECRET
apps/mcp-listings/.env - Add the same JWT_SECRET
apps/mcp-analytics/.env - Add the same JWT_SECRET
The JWT_SECRET must be identical across all services for authentication to work.
# First authenticate to get JWT token
TOKEN=$(curl -X POST http://localhost:3000/auth/login \ -H "Content-Type: application/json" \ -d '{"email": "user@example.com", "password": "securepassword123"}' \| jq -r '.access_token')# Connect to SSE stream
curl -X POST http://localhost:3000/agents/chat-stream \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: text/event-stream" \
-H "Cache-Control: no-cache" \
-d '{"userMessage": "Find me homes in Portland"}' \
--no-buffer
SSE Event Format
The server sends events in this format:
event: thinking
data: {"status": "processing", "message": "Analyzing your request..."}
event: content
data: {"chunk": "I found several great properties in Portland"}
event: content
data: {"chunk": " that match your criteria. Here are the top options:"}
event: done
data: {"status": "completed"}
JavaScript Client Example
// Connect to SSE endpointconsteventSource=newEventSource('/agents/chat-stream',{headers: {'Authorization': `Bearer ${token}`}});// Handle different event typeseventSource.addEventListener('thinking',(event)=>{constdata=JSON.parse(event.data);showThinkingIndicator(data.message);});eventSource.addEventListener('content',(event)=>{constdata=JSON.parse(event.data);appendToResponse(data.chunk);});eventSource.addEventListener('done',(event)=>{hideThinkingIndicator();markResponseComplete();});eventSource.addEventListener('error',(event)=>{handleStreamError(event);});
Delay: Optional delay between chunks for demo effect
Buffer: Response buffering strategies
Testing Streaming
The test suite includes SSE-specific testing:
# Run all tests including SSE tests
npm run test# Run SSE-specific tests
npm run test -w apps/main-app -- sse
# Test streaming with coverage
npm run test:cov
SSE test coverage includes:
Event stream creation and management
Authentication with streaming endpoints
Error handling and reconnection
Event type validation
Connection lifecycle testing
Development Tips
Testing SSE Locally
Use browser dev tools Network tab to see SSE connections
Monitor EventSource connection states
Test connection drops and reconnection
Verify event ordering and completeness
Common Issues
Connection drops: Check network stability and timeout settings
Auth failures: Ensure JWT token is valid and passed correctly
Event parsing: Verify JSON format in event data
Browser limits: Be aware of concurrent SSE connection limits
Performance Considerations
SSE connections are long-lived
Monitor server memory usage with many concurrent connections
Consider connection pooling for production
Implement proper cleanup on client disconnect
Next Steps
Congratulations! You've completed the full series. Here's what you've learned:
Part 1: part-1-chatbot-to-agent - Foundation with direct tool integration
Part 2: part-2-mcp-scaling - Microservices with MCP
Part 3: part-3-mcp-security - JWT authentication and security
Part 4: part-4-sse - Real-time streaming with Server-Sent Events
Production Deployment
This Part 4 implementation is production-ready with:
Secure authentication
Scalable microservices
Real-time user experience
Comprehensive error handling
Full test coverage
from https://github.com/lorenseanstewart/llm-tools-series
Dism++ is a free, open-source graphical user interface for Microsoft's built-in Deployment Image Servicing and Management (DISM) tool on Windows. [1, 2, 3]
Core Features
Drive Cleaner: Removes old Windows update files, temporary files, and system cache to free up storage. [1, 2, 3]
App Manager: Bulk uninstalls pre-installed Microsoft Store (Appx) packages. [1, 2]
Startup Inspector: Manages startup programs, services, and boot options. [1]
Updates & Images: Scans for, installs, or integrates Windows updates into live systems or offline .iso images. [1, 2, 3]
System Optimizer: Toggles various hidden Windows settings and interface tweaks. [1, 2]
Important Notes
Development Status: The project is older and receives infrequent updates from its creator Chuyu Team, though community translation mirrors remain active on SourceForge. [1, 2, 3]
Caution: Certain advanced features (like driver injection, deep boot repairs, or aggressive app removal) can destabilize modern Windows 10 or 11 builds if used improperly. [1, 2]
