# MCP Playground

A demonstration Model Context Protocol (MCP) server implementation in Go featuring **real-time bidirectional file communication**.

## 🎯 Features

- **Real-Time Communication**: Bidirectional file-based communication with live notifications
- **MCP Resources**: Live-updating resources with automatic change notifications  
- **File Monitoring**: External file changes detected and reported in real-time
- **Rich Tool Set**: Complete set of tools for file interaction and monitoring

## 🚀 Quick Start

```bash
# Build the server
task build

# Start monitoring and interact with the file
task run
```

## 🔧 MCP Tools

- `start_file_monitoring` - Start real-time file monitoring
- `write_to_file` - Write messages to communication file  
- `read_communication_file` - Read current file contents
- `get_recent_changes` - Get list of recent external changes
- `get_monitoring_status` - Check monitoring status

## 📡 MCP Resources

- `file://communication` - Live communication file with real-time updates

## 🧪 Testing

```bash
# Test real-time notifications
./test_realtime_resources.sh

# Test basic file monitoring  
./test_file_monitoring.sh
```

## 🔌 Claude Desktop Integration

Copy configuration to your Claude Desktop config:

```json
{
  "mcpServers": {
    "mcp-playground": {
      "command": "/path/to/mcp-playground/bin/mcp-playground",
      "args": []
    }
  }
}
```

## 📖 How It Works

1. **Start monitoring** with `start_file_monitoring` tool
2. **External changes** to `communication.txt` are detected automatically
3. **Real-time notifications** sent via MCP `notifications/resources/updated`
4. **Claude Desktop** receives live updates and can react to external changes

Perfect for experimenting with MCP real-time capabilities! 🎪