TruthLens: Misinformation Surveillance Platform

TruthLens：誤情報監視プラットフォーム

TruthLens は、AI アシスタントに誤情報の可能性を検出、分析、検証するツールを提供する Model Context Protocol（MCP）サーバーです。Python と MCP フレームワークで構築されており、ファクトチェックと誤情報の監視を自動化する機能を実現します。

📋 機能

• ウェブコンテンツの取り込み：URL やニュースソースからコンテンツを抽出します
• 主張の抽出：Google の Gemini AI を使用して、テキスト内の事実に関する主張を自動的に特定します
• 主張の検証：AI と外部の知識ソースを使用して、主張の真偽を評価します
• ニュースの監視：ニュースコンテンツを検索・分析し、誤情報を検出します
• トレンド分析：トピックごとに流行している誤情報を追跡し、報告します

🏗️ アーキテクチャ

┌───────────────────────────────────────────────────────────┐
│                    TruthLens MCP Server                   │
├───────────────┬───────────────────────┬───────────────────┤
│  Data Sources │      Core Tools       │  External APIs    │
├───────────────┼───────────────────────┼───────────────────┤
│               │                       │                   │
│  Web Content  │   ingest_url()        │   Google Gemini   │
│  News Sites   │   extract_claims()    │   NewsAPI         │
│  Social Media │   verify_claim()      │   Wikipedia API   │
│  Wikipedia    │   search_news()       │   Reddit API      │
│  Fact-check   │   analyze_source()    │   Fact Check API  │
│  Databases    │   get_trending_info() │                   │
│               │   setup_monitor()     │                   │
│               │                       │                   │
└───────────────┴───────────────────────┴───────────────────┘
                          │
                          ▼
┌───────────────────────────────────────────────────────────┐
│                    MCP Clients / AI Models                 │
└───────────────────────────────────────────────────────────┘

データフロー：

1. AI アシスタントまたは MCP クライアントが、主張や URL に関する情報をリクエストします
2. TruthLens サーバーがウェブソースからコンテンツを取り込むか、直接テキストを受け取ります
3. パターンマッチングまたは Gemini AI を使用して主張を抽出します
4. 複数のソース（Wikipedia、ファクトチェックデータベース）を使用して各主張を検証します
5. 証拠と信頼度スコアを添えて、結果をクライアントに返します

🚀 セットアップとインストール

前提条件

• Python 3.10 以降
• 外部サービスの API キー：
  • Google Gemini API（必須）
  • NewsAPI（任意）
  • Reddit API（任意）

UV を使用したインストール（推奨）

UV は、高速な Python パッケージインストーラー兼リゾルバーです。UV を使用して TruthLens をインストールし、実行する手順は次のとおりです。

1. UV をインストールする（まだインストールされていない場合）

   pip install uv
   

2. このリポジトリをクローンする

   git clone <repository-url>
   cd MCP\ Build
   

3. 仮想環境を作成して有効化する

   uv venv
   # On Windows
   .venv\Scripts\activate
   # On macOS/Linux
   source .venv/bin/activate
   

4. 依存関係をインストールする

   uv pip install -r requirements.txt
   

5. API キーを設定する

   • ルートディレクトリに .env という名前の新しいファイルを作成します
   • 次の形式で API キーを追加します

   # TruthLens API Keys
   # Replace placeholder values with your actual API keys
   
   # Google Gemini API Key (required for LLM-based claim extraction and verification)
   # Get it from: https://aistudio.google.com/app/apikey
   GEMINI_API_KEY=your_gemini_api_key_here
   
   # NewsAPI Key (used for fetching news articles)
   # Get it from: https://newsapi.org/
   NEWSAPI_KEY=your_newsapi_key_here
   
   # Reddit API Credentials (optional, for production use)
   # Get from: https://www.reddit.com/prefs/apps
   # Instructions:
   #  1. Click "Create App" button at the bottom
   #  2. Select "script" for personal use
   #  3. Fill in name (e.g., "TruthLens")
   #  4. For redirect URI, use: http://localhost:8000 (even though this app doesn't use it)
   #  5. After creation, you'll receive a client ID and secret
   REDDIT_CLIENT_ID=your_reddit_client_id_here
   REDDIT_CLIENT_SECRET=your_reddit_client_secret_here
   REDDIT_USER_AGENT=TruthLens/0.1 (by /u/YourUsername)
   
   # Google Fact Check Tools API Key (optional, for production use)
   # Get from: https://developers.google.com/fact-check/tools/api/
   FACTCHECK_API_KEY=your_factcheck_api_key_here
   

   重要な注意事項：

   • AI を活用した分析には、最低限 GEMINI_API_KEY が必要です
   • API キーがない場合、システムはパターンマッチングとデモデータにフォールバックします
   • .env ファイルをバージョン管理にコミットしないでください

6. サーバーを実行する

   python run_server.py
   

pip を使用した別のインストール方法

UV がインストールされていない場合は、pip を使用できます。

python -m venv .venv
# On Windows
.venv\Scripts\activate
# On macOS/Linux
source .venv/bin/activate
pip install -r requirements.txt
python run_server.py

🧪 テスト

MCP エンドポイントにリクエストを送信して、サーバーをテストします。

1. 基本的なデモリソース

   truthlens://demo
   

2. ツールの使用例

   ingest_url(url="https://en.wikipedia.org/wiki/COVID-19_vaccine")
   extract_claims(text="Vaccines are effective at preventing serious illness.")
   verify_claim(claim_text="Climate change is caused by human activities.")
   

📚 API キー

このプロジェクトでは、次の API キーを使用します。

1. Google Gemini API - AI による主張の抽出と検証に必要です

   • 入手先：https://aistudio.google.com/app/apikey

2. NewsAPI - ニュース検索機能に使用します

   • 入手先：https://newsapi.org/

3. Reddit API - ソーシャルメディアコンテンツの監視に使用します（任意）

   • 入手先：https://www.reddit.com/prefs/apps

⚠️ 制限事項

• 現在の実装ではメモリ内ストレージを使用しているため、本番環境には適していません
• パターンマッチングへのフォールバックは、AI を活用した分析に比べて精度が限られています
• ウェブスクレイピングには、レート制限や利用規約による制約が適用される場合があります

📝 ライセンス

MIT ライセンス

🤝 貢献

貢献を歓迎します。お気軽にプルリクエストをお送りください。