22
33** Web search and content extraction for AI models via Model Context Protocol (MCP)**
44
5- [ ![ Version] ( https://img.shields.io/badge/version-2.3.1 -blue.svg )] ( https://github.com/Kode-Rex/webcat )
5+ [ ![ Version] ( https://img.shields.io/badge/version-2.3.2 -blue.svg )] ( https://github.com/Kode-Rex/webcat )
66[ ![ License] ( https://img.shields.io/badge/license-MIT-green.svg )] ( LICENSE )
77[ ![ Docker] ( https://img.shields.io/badge/docker-multi--platform-blue.svg )] ( https://hub.docker.com/r/tmfrisinger/webcat )
88
@@ -29,23 +29,19 @@ docker run -p 8000:8000 -e WEBCAT_API_KEY=your_token tmfrisinger/webcat:latest
2929cd docker
3030python -m pip install -e " .[dev]"
3131
32- # Start demo server with UI
33- python simple_demo.py
32+ # Start MCP server with auto-reload
33+ make dev
3434
35- # Or use make commands
36- make dev # Start with auto-reload
37- make dev-demo # Start demo with auto-reload
35+ # Or run directly
36+ python mcp_server.py
3837```
3938
40- ![ WebCat Demo Client] ( assets/webcat-demo-client.png )
41-
4239## What is WebCat?
4340
4441WebCat is an ** MCP (Model Context Protocol) server** that provides AI models with:
4542- 🔍 ** Web Search** - Serper API (premium) or DuckDuckGo (free fallback)
4643- 📄 ** Content Extraction** - Clean markdown conversion with Readability + html2text
4744- 🌐 ** SSE Streaming** - Real-time results via Server-Sent Events
48- - 🎨 ** Demo UI** - Interactive testing interface
4945- 🐳 ** Multi-Platform Docker** - Works on Intel, ARM, and Apple Silicon
5046
5147Built with ** FastAPI** , ** FastMCP** , and ** Readability** for seamless AI integration.
@@ -89,18 +85,15 @@ echo "SERPER_API_KEY=your_key" > .env
8985
9086# Development mode with auto-reload
9187make dev # Start MCP server with auto-reload
92- make dev-demo # Start demo server with auto-reload
9388
9489# Production mode
9590make mcp # Start MCP server
96- make demo # Start demo server
9791```
9892
9993## Available Endpoints
10094
10195| Endpoint | Description |
10296| ----------| -------------|
103- | ` http://localhost:8000/demo ` | 🎨 Interactive demo UI |
10497| ` http://localhost:8000/health ` | 💗 Health check |
10598| ` http://localhost:8000/status ` | 📊 Server status |
10699| ` http://localhost:8000/mcp ` | 🛠️ MCP protocol endpoint |
@@ -226,7 +219,7 @@ Hooks run automatically on `git commit` to ensure code quality. Install with `ma
226219```
227220docker/
228221├── mcp_server.py # Main MCP server (FastMCP)
229- ├── simple_demo .py # Demo server with interactive UI
222+ ├── cli .py # CLI interface for server modes
230223├── health.py # Health check endpoint
231224├── api_tools.py # API tooling utilities
232225├── clients/ # External API clients
@@ -270,7 +263,7 @@ cd docker
270263
271264# Manual multi-platform build and push
272265docker buildx build --platform linux/amd64,linux/arm64 \
273- -t tmfrisinger/webcat:2.3.1 \
266+ -t tmfrisinger/webcat:2.3.2 \
274267 -t tmfrisinger/webcat:latest \
275268 -f Dockerfile --push .
276269
@@ -281,8 +274,8 @@ docker buildx imagetools inspect tmfrisinger/webcat:latest
281274** Automated Releases:**
282275Push a version tag to trigger automated multi-platform builds via GitHub Actions:
283276``` bash
284- git tag v2.3.1
285- git push origin v2.3.1
277+ git tag v2.3.2
278+ git push origin v2.3.2
286279```
287280
288281## Limitations
@@ -317,4 +310,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
317310
318311---
319312
320- ** Version 2.3.1 ** | Built with FastMCP, FastAPI, Readability, and html2text
313+ ** Version 2.3.2 ** | Built with FastMCP, FastAPI, Readability, and html2text
0 commit comments