Sentimatix

Sentimatix MCP Server

**Model Context Protocol（MCP）**を通じて、インド株式市場のリアルタイム情報を提供します。Sentimatix を Claude Desktop、Cursor、または MCP 対応の AI エージェントに直接接続して、NSE/BSE のリアルタイムのセンチメント、ニュース、テクニカル分析を取得できます。

🏗️ アーキテクチャ

User Query → Claude/AI Agent → MCP Server → Tools
                                   ↓
                              ┌─────────────────────┐
                              │ News Sentiment API  │ ← Sentimatix /api/v1/news
                              │ Stock Price API     │ ← Sentimatix /api/v1/stocks
                              │ Sector Sentiment    │ ← Sentimatix /api/v1/sentiment
                              │ RAG Evidence        │ ← Supabase Vector DB
                              └─────────────────────┘
                                   ↓
                              Synthesized Market Intelligence

🛠️ 利用可能なツール（全 10 種類）

ツール	説明	例
explain_price_change	オーケストレーター — 株価、ニュース、センチメントを使って、株価が動いた理由を説明します	(RELIANCE, 7 days)
analyze_stock_enhanced	個別銘柄の詳細な調査レポート	(HDFCBANK, detailed)
compare_stocks	NSE の 2 銘柄を並べて比較します	(TCS vs INFY)
get_stock_summary	株価指標：変動率、高値、安値、出来高	(TATAMOTORS, 7 days)
get_historical_prices	日次 OHLCV 時系列データ	(SBIN, 2024-01-01, 2024-03-01)
get_news_sentiment	NLP によるセンチメントスコア付きニュース記事	(ZOMATO, last 7 days)
get_sentiment_aggregate	期間ごとのセンチメント統計の集計	(ADANIENT, 30 days)
get_technical_analysis	RSI、MACD、ボリンジャーバンド、サポート／レジスタンス	(ITC, 90 days)
calculate_correlation	NSE の 2 銘柄間のピアソン相関	(RELIANCE, TCS)
get_rag_evidence	ニュースコーパスのセマンティック検索	(INFY, "earnings beat")

🚀 クイックスタート（Claude Desktop）

1. 無料の API キーをこちらから取得します：https://sentimatix-production.up.railway.app/portal
2. claude_desktop_config.json に次の内容を追加します：

{
  "mcpServers": {
    "sentimatix": {
      "command": "uvx",
      "args": ["sentimatix-mcp"],
      "env": {
        "BACKEND_API_URL": "https://sentimatix-production.up.railway.app/api",
        "SENTIMATIX_API_KEY": "your_key_here"
      }
    }
  }
}

📊 クエリの実行例

ユーザー：「過去 7 日間で Reliance の株価が下落したのはなぜですか？」

MCP のワークフロー：

1. ✅ get_stock_summary("RELIANCE", 7) → -3.1% decline
2. ✅ get_news_sentiment("RELIANCE", ...) → 12 news items, avg sentiment: -0.4
3. ✅ get_rag_evidence("RELIANCE", "price drop reasons") → 5 relevant articles
4. ✅ get_technical_analysis("RELIANCE") → RSI: 38 (Oversold), MACD: Bearish
5. 🤖 LLM による統合：

RELIANCE declined 3.1% (₹2,850 → ₹2,762) over the last 7 days.

Top Reasons (with evidence):
1. Weak Q4 refining margins — reported by Economic Times (sentiment: -0.5)
2. Sector-wide FII selling in Oil & Gas — MoneyControl (sentiment: -0.3)
3. RSI at 38 confirms oversold territory; key support at ₹2,740

Confidence: HIGH

🔧 環境変数

BACKEND_API_URL=https://sentimatix-production.up.railway.app/api
SUPABASE_URL=https://your-project.supabase.co       # For RAG features
SUPABASE_KEY=your_anon_key                           # For RAG features
OPENAI_API_KEY=your_openai_key                       # For AI synthesis

📚 ドキュメント全文

• 接続ガイド — Claude Desktop、Cursor のセットアップ
• クイックスタート — 手順に沿ったインストール
• REST API ドキュメント — OpenAPI リファレンス全文