mcp-server-fear-greed

MCP 服务恐惧与贪婪指数

一个 Model Context Protocol（MCP）服务，可访问美国股市的 CNN 恐惧与贪婪指数。此服务会获取实时市场情绪数据，并以 structuredContent 和文本 content 两种形式呈现。

功能

• 实时恐惧与贪婪指数：获取当前市场情绪评分（0-100）
• 历史对比：查看前一日收盘、前一周、前一月和前一年的数据
• 详细的市场指标：获取各个组成部分的评分，包括：
  • 市场动能（S&P 500 和 S&P 125）
  • 股票价格强度和广度
  • 看跌/看涨期权比率
  • 市场波动率（VIX）
  • 垃圾债券需求
  • 避险资产需求
• 灵活的输出：可选择结构化 Markdown 或原始 JSON 格式

要求

• Node.js 18 或更高版本
• VS Code、Cursor、Windsurf、Claude Desktop 或其他 MCP 客户端

快速开始

本地（Stdio）

首先，在客户端中安装恐惧与贪婪 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

你可以使用以下两个 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"
    }
  }
}

将 url 设置为 Streamable HTTP 端点：

{
  "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 开发，可以直接使用进程内调用，避免要求用户安装命令行界面才能使用恐惧与贪婪 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

获取当前恐惧与贪婪指数及相关市场指标。

参数

• 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"
  }
}

恐惧与贪婪指数评级

该指数采用以下评级标准：

• 0-25：极度恐惧
• 26-45：恐惧
• 46-55：中性
• 56-75：贪婪
• 76-100：极度贪婪

开发

访问 http://127.0.0.1:6274/：

npm run dev

错误处理

该服务包含全面的错误处理机制：

• 捕获并报告网络请求失败
• 妥善处理无效的 API 响应
• 使用合理的默认值填充缺失的数据字段
• 所有错误均包含描述性消息