- Complete Rentcast API integration with all endpoints - Intelligent caching system with hit/miss tracking - Rate limiting with exponential backoff - User confirmation system with MCP elicitation support - Docker Compose setup with dev/prod modes - PostgreSQL database for persistence - Comprehensive test suite foundation - Full project structure and documentation
36 lines
947 B
Markdown
36 lines
947 B
Markdown
# mcrentcast - Rentcast MCP Server
|
|
|
|
A Model Context Protocol (MCP) server that provides intelligent access to the Rentcast API with advanced caching, rate limiting, and cost management features.
|
|
|
|
## Features
|
|
|
|
- 🏠 Complete Rentcast API integration
|
|
- 💾 Intelligent caching with hit/miss tracking
|
|
- 🛡️ Rate limiting with exponential backoff
|
|
- 💰 Cost management and API usage tracking
|
|
- ✨ MCP elicitation for user confirmations
|
|
- 🐳 Docker Compose development environment
|
|
- 🧪 Comprehensive test suite with beautiful reports
|
|
|
|
## Quick Start
|
|
|
|
1. Copy environment configuration:
|
|
```bash
|
|
cp .env.example .env
|
|
```
|
|
|
|
2. Set your Rentcast API key in `.env`:
|
|
```bash
|
|
RENTCAST_API_KEY=your_api_key_here
|
|
```
|
|
|
|
3. Start the development environment:
|
|
```bash
|
|
make dev
|
|
```
|
|
|
|
## Development
|
|
|
|
This project uses uv for Python dependency management and Docker Compose for the development environment.
|
|
|
|
See `docs/` directory for detailed documentation. |