项目简介

这是一个基于 Model Context Protocol (MCP) 构建的服务器，专门用于提供加密货币恐惧与贪婪指数 (Fear & Greed Index, F&G) 的数据。它通过标准化的方式向兼容 MCP 的大语言模型 (LLM) 客户端（如 Claude Desktop）提供这些信息，帮助 LLM 更好地理解和分析加密货币市场的当前情绪。

主要功能点

• 获取当前指数: 随时查询最新的加密货币恐惧与贪婪指数数值及其对应的市场情绪分类（如恐惧、贪婪）。
• 获取历史数据: 查询过去指定天数的指数历史数据，了解指数随时间的变化。
• 趋势分析: 对指定天数的历史数据进行统计分析，提供平均值、趋势方向（上涨、下跌或稳定）等信息。
• LLM 工具: 所有数据查询和分析功能都封装为工具，LLM 可以直接调用以获取结构化信息。
• Prompt 模板: 提供用于解释和分析指数数值的 Prompt 模板，引导 LLM 进行有意义的解读。

安装步骤

安装此 MCP 服务器通常有两种主要方式：

1. 通过 Smithery 安装 (推荐给 Claude Desktop 用户): 如果您使用 Claude Desktop 并希望通过 Smithery 安装，打开终端并运行以下命令：

   npx -y @smithery/cli install @kukapay/crypto-feargreed-mcp --client claude
   

   这会自动将服务器安装到 Claude Desktop 的 MCP 服务器目录中。安装完成后，您可能需要在 Claude Desktop 的设置中启用该服务器。

2. 手动安装: 如果您使用其他兼容 MCP 的客户端或希望手动安装： 首先，克隆项目仓库到您的本地计算机：

   git clone https://github.com/kukapay/crypto-feargreed-mcp.git
   cd crypto-feargreed-mcp
   

   然后，您需要配置您的 MCP 客户端以启动此服务器。此服务器使用 Python 运行，并依赖 'uv'（或 'python' 和 'pip'）。最简单的方式是使用 'uv' 运行 'main.py' 文件。

服务器配置

MCP 客户端需要配置其 MCP 服务器列表才能连接并使用此服务。您需要在客户端的配置文件（通常是 JSON 格式）中添加一个服务器条目，指定如何启动此 MCP 服务器。

配置信息通常包含：

• 服务器名称 (Server Name): 您为此服务器指定的唯一名称（例如 '"crypto-feargreed-mcp"'）。
• 启动命令 (Command): 用于执行服务器代码的可执行文件路径。如果您使用 'uv' 运行 Python 脚本，这通常是 '"uv"'。如果您直接使用 Python，则为 Python 解释器路径，例如 '"python"'。
• 启动参数 (Args): 传递给启动命令的参数列表。对于 'uv' 运行 'main.py'，参数可能是 '["--directory", "/您的/项目/路径", "run", "main.py"]'。其中 '/您的/项目/路径' 需要替换为您的 'crypto-feargreed-mcp' 项目所在的实际文件路径。对于直接使用 Python 运行 'main.py'，参数可能是 '["/您的/项目/路径/main.py"]'。

具体的配置格式和位置取决于您使用的 MCP 客户端，请查阅您客户端的文档。

基本使用方法

配置并启动服务器后，您可以通过连接的 LLM 客户端直接提问，LLM 将利用该服务器提供的工具来获取信息。例如，您可以尝试问：

• "现在的加密货币恐惧与贪婪指数是多少？"
• "请告诉我过去 7 天的加密货币恐惧与贪婪指数历史数据。"
• "分析一下最近 30 天的加密货币恐惧与贪婪指数趋势。"
• "请解释一下指数值 45 代表什么市场情绪？"

LLM 客户端会识别这些请求并自动调用相应的服务器工具来获取数据并回答您的问题。