MCP Server Fear Greed

🚀 MCP Server Fear & Greed Index

このModel Context Protocol (MCP)サーバーは、米国株式市場のCNN Fear & Greed Indexにアクセスできるようにします。このサーバーはリアルタイムの市場センチメントデータを取得し、structuredContentとテキストcontentの両方で表示します。

✨ 主な機能

• リアルタイムのFear & Greed Index：現在の市場センチメントスコア（0 - 100）を取得します。
• 過去の比較：前の終値、週、月、年のデータを表示できます。
• 詳細な市場指標：以下を含む個々の構成要素のスコアにアクセスできます。
  • 市場勢い（S&P 500 & S&P 125）
  • 株価の強さと幅
  • プット/コールオプション比率
  • 市場ボラティリティ（VIX）
  • ジャンク債の需要
  • 安全資産の需要
• 柔軟な出力形式：構造化されたMarkdownまたは生のJSON形式を選択できます。

📦 インストール

必要条件

• Node.js 18以上
• VS Code、Cursor、Windsurf、Claude Desktopまたはその他のMCPクライアント

ローカル（Stdio）

まず、クライアントでFear & Greed MCPサーバーをインストールします。典型的な設定は次のようになります。

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-fear-greed@latest"
      ]
    }
  }
}

# For VS Code
code --add-mcp '{"name":"mcp-server-fear-greed","command":"npx","args":["mcp-server-fear-greed@latest"]}'

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "mcp-server-fear-greed@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "mcp-server-fear-greed@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "command": "npx",
      "args": [
        "mcp-server-fear-greed@latest"
      ]
    }
  }
}

リモート（SSE / Streamable HTTP）

同時に、--port $your_port引数を使用して、ブラウザのmcpをSSEおよびStreamable HTTPサーバーに変換できます。

# normal run remote mcp server
npx mcp-server-fear-greed --port 8089

2つのMCPサーバーリモートエンドポイントのいずれかを使用できます。

• Streamable HTTP（推奨）: http://127.0.0.1::8089/mcp
• SSE: http://127.0.0.1::8089/sse

そして、MCPクライアントの設定で、urlをSSEエンドポイントに設定します。

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "url": "http://127.0.0.1::8089/sse"
    }
  }
}

Streamable HTTPのurlは次のように設定します。

{
  "mcpServers": {
    "mcp-server-fear-greed": {
      "type": "streamable-http", // If there is MCP Client support
      "url": "http://127.0.0.1::8089/mcp"
    }
  }
}

インメモリ呼び出し

MCPクライアントがJavaScript / TypeScriptをベースに開発されている場合、プロセス内呼び出しを直接使用して、ユーザーにコマンドラインインターフェイスをインストールさせることなくFear & Greed MCPを使用できます。

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { InMemoryTransport } from '@modelcontextprotocol/sdk/inMemory.js';

// type: module project usage
import { createServer } from 'mcp-server-fear-greed';
// commonjs project usage
// const { createServer } = await import('mcp-server-fear-greed')

const client = new Client(
  {
    name: 'test fear greed client',
    version: '1.0',
  },
  {
    capabilities: {},
  },
);

const server = createServer();
const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();

await Promise.all([
  client.connect(clientTransport),
  server.connect(serverTransport),
]);

// list tools
const result = await client.listTools();
console.log(result);

// call tool
const toolResult = await client.callTool({
  name: 'get_fear_greed_index',
  arguments: {
    format: 'json'
  },
});
console.log(toolResult);

📚 詳細ドキュメント

APIリファレンス

ツール: get_fear_greed_index

現在のFear & Greed Indexと関連する市場指標を取得します。

パラメーター

• format (オプション): 出力形式
  • "structured" (デフォルト): 整理されたデータを含むフォーマット済みのMarkdownを返します。
  • "json": 生のJSONデータを返します。

使用例

// Get structured output
await client.callTool("get_fear_greed_index");

// Get JSON output
await client.callTool("get_fear_greed_index", { format: "json" });

レスポンス構造

このツールは次の構造でデータを返します。

{
  "fear_and_greed": {
    "score": 75,
    "rating": "greed",
    "timestamp": "2025-07-18T23:59:57+00:00",
    "previous_close": 75.31,
    "previous_1_week": 75.26,
    "previous_1_month": 54.29,
    "previous_1_year": 45.94
  },
  "fear_and_greed_historical": {
    "timestamp": 1752883197000,
    "score": 75,
    "rating": "greed"
  },
  "market_momentum_sp500": {
    "timestamp": 1752871567000,
    "score": 61.2,
    "rating": "greed"
  },
  "market_momentum_sp125": {
    "timestamp": 1752871567000,
    "score": 61.2,
    "rating": "greed"
  },
  "stock_price_strength": {
    "timestamp": 1752883197000,
    "score": 80,
    "rating": "extreme greed"
  },
  "stock_price_breadth": {
    "timestamp": 1752883197000,
    "score": 84,
    "rating": "extreme greed"
  },
  "put_call_options": {
    "timestamp": 1752871897000,
    "score": 79.6,
    "rating": "extreme greed"
  },
  "market_volatility_vix": {
    "timestamp": 1752869701000,
    "score": 50,
    "rating": "neutral"
  },
  "market_volatility_vix_50": {
    "timestamp": 1752869701000,
    "score": 50,
    "rating": "neutral"
  },
  "junk_bond_demand": {
    "timestamp": 1752877800000,
    "score": 88.8,
    "rating": "extreme greed"
  },
  "safe_haven_demand": {
    "timestamp": 1752868799000,
    "score": 81.4,
    "rating": "extreme greed"
  }
}

Fear & Greed Indexの評価

この指数は次の評価スケールを使用しています。

• 0 - 25: 極度の恐怖
• 26 - 45: 恐怖
• 46 - 55: 中立
• 56 - 75: 貪欲
• 76 - 100: 極度の貪欲

開発

http://127.0.0.1:6274/にアクセスします。

npm run dev

エラーハンドリング

サーバーには包括的なエラーハンドリングが含まれています。

• ネットワーク要求の失敗は捕捉され、報告されます。
• 無効なAPIレスポンスは適切に処理されます。
• 欠落しているデータフィールドは適切なデフォルト値で埋められます。
• すべてのエラーには説明的なメッセージが含まれています。