Sentiment + Sarcasm Analyzer

Sentiment + Sarcasm Analyzer (Gradio + MCP)

This project is a lightweight Gradio application that performs sentiment analysis and sarcasm detection using Hugging Face Transformers. It is designed to run on CPU and was developed as part of the Hugging Face MCP Course. The app is fully compatible with the Hugging Face MCP server architecture.

Live Demo

👉 Launch the app on Hugging Face Spaces

Architecture Overview

Models (CPU-only):
- distilbert-base-uncased-finetuned-sst-2-english: Sentiment analysis
- helinivan/english-sarcasm-detector: Sarcasm detection
Frontend: Gradio UI
Backend: Python with Hugging Face Transformers
MCP Integration: Hugging Face MCP-compatible (gradio[mcp])

Features

Sentiment classification: "positive" or "negative"
Sarcasm detection with a probability score
CPU-compatible (no GPU required)
Simple and clean Gradio interface

Output Format

The app returns a structured JSON response with four fields:

{
  "assessment": "positive",
  "confidence": 1.0,
  "sarcasm_detected": true,
  "sarcasm_confidence": 0.97
}

Gradio Interface

The interface provides the following controls:

Element	Description
Textbox	Enter text to be analyzed
Submit	Run the sentiment and sarcasm analysis
Clear	Reset the input/output

Setup Instructions

1. Clone the repository

git clone https://github.com/YOUR_USERNAME/mcp-sentiment
cd mcp-sentiment

2. Create a virtual environment

python -m venv .venv
# Then activate:
.venv\Scripts\activate      # Windows
source .venv/bin/activate     # macOS/Linux

3. Install dependencies

pip install -r requirements.txt

Make sure gradio[mcp] is included for MCP compatibility.

4. Add Hugging Face token

Create a .env file:

HF_TOKEN=your_token_here

5. Run the app locally

python app.py

Deploy to Hugging Face Spaces

git init
git remote add origin https://huggingface.co/spaces/YOUR_USERNAME/mcp-sentiment
git add .
git commit -m "Deploy MCP app"
git push -u origin main

Once pushed, the MCP server endpoint will be live at:

https://YOUR_USERNAME-mcp-sentiment.hf.space/gradio_api/mcp/sse

Credits

Hugging Face MCP Course
Model: distilbert-base-uncased-finetuned-sst-2-english
Model: helinivan/english-sarcasm-detector
Gradio

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

A lightweight Gradio application that analyzes text for sentiment (positive/negative) and sarcasm detection using Hugging Face Transformers, designed to run on CPU and compatible with the MCP server architecture.

Related MCP Servers

Game Asset Generator
MubarakHAlketbi
-
security
A
license
-
quality
An MCP server that generates 2D and 3D game assets from text prompts using AI models from Hugging Face Spaces, allowing developers to easily create game art through Claude Desktop or other MCP clients.
Last updated -
34
JavaScript
MIT License
Grumpy Senior Developer MCP
sinedied
-
security
A
license
-
quality
An MCP server that reviews code with the sarcastic and cynical tone of a grumpy senior developer, helping identify issues in PRs and providing feedback on code quality.
Last updated -
22
10
JavaScript
MIT License
MCP Server Demo
pablomartinferrari
-
security
F
license
-
quality
A simplified Model Context Protocol server in Python that reads text input and generates humorous responses, with support for Docker and Azure deployment.
Last updated -
Sentiment Analysis MCP Server
Aiden-Jeon
-
security
F
license
-
quality
An MCP server that provides sentiment analysis functionality using TextBlob, allowing users to analyze text for polarity, subjectivity, and sentiment assessment through Cursor AI.
Last updated -
Python

View all related MCP servers

Sentiment + Sarcasm Analyzer