MCP Sentiment

🚀 情感 + 諷刺分析器 (Gradio + MCP)

本項目是一個輕量級的Gradio應用程序，它藉助Hugging Face Transformers來執行情感分析和諷刺檢測。該應用旨在能在CPU上運行，是Hugging Face MCP課程的一部分。此應用完全兼容Hugging Face MCP服務器架構。

🚀 快速開始

👉 在Hugging Face Spaces上啟動應用

✨ 主要特性

• 情感分類：分為“積極”或“消極”。
• 帶有概率得分的諷刺檢測。
• 支持CPU運行（無需GPU）。
• 擁有簡潔乾淨的Gradio界面。

🔧 技術細節

架構概述

• 模型（僅支持CPU）：
  • distilbert-base-uncased-finetuned-sst-2-english：用於情感分析。
  • helinivan/english-sarcasm-detector：用於諷刺檢測。
• 前端：Gradio用戶界面。
• 後端：使用Hugging Face Transformers的Python程序。
• MCP集成：兼容Hugging Face MCP（gradio[mcp]）。

輸出格式

該應用返回一個包含四個字段的結構化JSON響應：

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

Gradio界面

該界面提供以下控件：

📦 安裝指南

1. 克隆倉庫

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

2. 創建虛擬環境

python -m venv .venv
# 然後激活：
.venv\Scripts\activate      # Windows
source .venv/bin/activate     # macOS/Linux

3. 安裝依賴項

pip install -r requirements.txt

確保為了MCP兼容性包含了gradio[mcp]。

4. 添加Hugging Face令牌

創建一個.env文件：

HF_TOKEN=your_token_here

5. 在本地運行應用

python app.py

部署到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

推送完成後，MCP服務器端點將在以下地址生效：

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

📄 許可證

此項目的相關模型和技術依賴於以下資源：

• Hugging Face MCP課程
• 模型：distilbert-base-uncased-finetuned-sst-2-english
• 模型：helinivan/english-sarcasm-detector
• Gradio