MCP Sentiment

🚀 感情 + 皮肉検出アナライザー (Gradio + MCP)

このプロジェクトは、Hugging Face Transformersを使用して感情分析と皮肉検出を行う軽量なGradioアプリケーションです。CPU上で実行するように設計されており、Hugging Face MCPコースの一環として開発されました。このアプリは、Hugging Face MCPサーバーアーキテクチャと完全に互換性があります。

🚀 クイックスタート

ライブデモ

👉 Hugging Face Spacesでアプリを起動

アーキテクチャの概要

• モデル (CPUのみ):

  • distilbert-base-uncased-finetuned-sst-2-english: 感情分析
  • helinivan/english-sarcasm-detector: 皮肉検出

• フロントエンド: Gradio UI

• バックエンド: Hugging Face Transformersを使用したPython

• MCP統合: Hugging Face MCP互換 (gradio[mcp])

✨ 主な機能

• 感情分類: "positive" または "negative"
• 確率スコア付きの皮肉検出
• CPU互換 (GPU不要)
• シンプルでクリーンなGradioインターフェイス

💻 使用例

出力形式

アプリは、4つのフィールドを持つ構造化された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