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

# 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

# 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:

{
  "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! 🎪