README.md•3.14 kB
# Utility MCP Server
General-purpose MCP server providing utility tools for Computer Agent ecosystem integration.
## Features
### DateTime Tools ⭐ NEW
- **Tool**: `get_current_datetime`
- **Purpose**: Get current date/time in any timezone with multiple format options
- **Status**: ✅ **Ready** - No configuration required
- **Timezones**: Full pytz database support (UTC, US/Eastern, Europe/London, America/Sao_Paulo, etc.)
- **Formats**: ISO, readable, timestamp, custom
- **Tool**: `calculate_time_difference`
- **Purpose**: Calculate time differences between dates or from a date to now
- **Status**: ✅ **Ready** - No configuration required
- **Features**: Detailed breakdown (days, hours, minutes, seconds), multiple input formats
### Read.AI Meeting Downloader
- **Tool**: `download_meeting_data`
- **Purpose**: Download meeting transcripts and summaries from Read.AI platform
- **Status**: ⚠️ **API Key Required** - Read.AI API documentation not publicly available
- **Configuration**: Requires `READ_AI_API_KEY` environment variable
### Server Status
- **Tool**: `util_server_status`
- **Purpose**: Check configuration and availability of all utility tools
## Installation
```bash
cd /home/danfmaia/_repos/_mcp/util-mcp
uv install
```
## Usage
### MCP Server (via Cursor)
The server is configured in `/home/danfmaia/.cursor/mcp.json`:
```json
{
"utilities": {
"name": "Utility MCP Server",
"type": "command",
"command": "/home/danfmaia/.local/bin/uv",
"args": [
"--directory",
"/home/danfmaia/_repos/_mcp/util-mcp",
"run",
"util_server.py"
]
}
}
```
### Standalone Testing
```bash
uv run util_server.py
```
### Testing DateTime Tools
```bash
uv run python test_datetime.py
```
## Usage Examples
### DateTime Tools
**Get current time in different timezones:**
- `get_current_datetime("UTC", "readable")` → "Tuesday, September 09, 2025 at 11:56:34 PM UTC"
- `get_current_datetime("America/Sao_Paulo", "iso")` → "2025-09-09T20:56:34-03:00"
- `get_current_datetime("US/Eastern", "custom")` → "2025-09-09 19:56:34 EDT"
**Calculate time differences:**
- `calculate_time_difference("2025-09-09 10:00:00", "2025-09-09 14:30:00", "UTC")` → "4 hours, 30 minutes"
- `calculate_time_difference("2025-09-08 15:00:00", "", "UTC")` → Time from yesterday 3pm to now
## Technical Constraints
### Read.AI API Limitation
**Current Status**: No publicly available Read.AI API documentation or third-party access endpoints identified.
**Search Evidence**:
- Cursor native @Web search: No API documentation found
- Custom MCP web research: No API endpoints discovered
- Technical assessment: Browser automation would require significant maintenance overhead
**Recommendation**: Manual download workflow until Read.AI provides official API access.
## Dependencies
- `mcp`: Model Context Protocol framework
- `httpx`: HTTP client for potential API calls
- `pytz`: Timezone database for datetime operations
- `fastmcp`: Simplified MCP server development
## Development
Built using FastMCP framework for simplified MCP server development and maintenance.