Create README.md

README.md

@@ -0,0 +1,82 @@
+---
+title: MCP Sentiment Analysis
+emoji: 🎭
+colorFrom: blue
+colorTo: purple
+sdk: gradio
+sdk_version: 5.0.0
+app_file: app.py
+pinned: false
+---
+
+# 🎭 Text Sentiment Analysis with MCP
+
+A powerful sentiment analysis tool built with Gradio and TextBlob, featuring Model Context Protocol (MCP) server integration for AI assistant interoperability.
+
+## 🚀 Features
+
+- **Real-time Sentiment Analysis**: Analyze the emotional tone of any text instantly
+- **Polarity Score**: Measures sentiment from -1 (negative) to +1 (positive)
+- **Subjectivity Score**: Evaluates objectivity (0) vs subjectivity (1)
+- **MCP Server Integration**: Expose sentiment analysis as a tool for AI assistants
+- **Clean Web Interface**: User-friendly Gradio interface
+
+## 📊 How It Works
+
+The application uses **TextBlob**, a Python library for natural language processing that:
+1. Tokenizes and analyzes input text
+2. Applies sentiment lexicon algorithms
+3. Returns polarity, subjectivity, and overall assessment
+
+### Output Metrics
+
+- **Polarity**: Emotional tone ranging from -1.0 (very negative) to +1.0 (very positive)
+- **Subjectivity**: Opinion level from 0.0 (objective/factual) to 1.0 (subjective/opinionated)
+- **Assessment**: Simple classification (positive, negative, or neutral)
+
+## 💡 Example Usage
+
+**Input:**
+```
+I absolutely love this product! It's amazing!
+```
+
+**Output:**
+```json
+{
+  "polarity": 0.75,
+  "subjectivity": 0.95,
+  "assessment": "positive"
+}
+```
+
+## 🔧 Technologies Used
+
+- **Gradio**: Web UI framework with MCP support
+- **TextBlob**: NLP library for sentiment analysis
+- **Python 3.13**: Core programming language
+
+## 🤖 MCP Integration
+
+This Space runs as an MCP server, allowing AI assistants (like Claude) to discover and use the `sentiment_analysis` function as a tool. This enables AI assistants to analyze sentiment in real-time during conversations.
+
+## 🛠️ Local Development
+
+```bash
+# Clone the repository
+git clone https://huggingface.co/spaces/SpringDai/mcp-sentiment
+
+# Install dependencies
+pip install -r requirements.txt
+
+# Run the application
+python app.py
+```
+
+## 📝 License
+
+Open source - feel free to use and modify!
+
+## 👤 Author
+
+Created by [SpringDai](https://huggingface.co/SpringDai)