mcrentcast/README.md
Ryan Malloy 8b4f9fbfff Initial implementation of mcrentcast MCP server
- 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
2025-09-09 08:41:23 -06:00

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.