crypto-sentiment-mcp

🚀 加密货币情感分析MCP服务器

本MCP服务器专为AI代理提供加密货币情感分析服务，借助Santiment聚合的社交媒体与新闻数据，追踪市场情绪，助力发现新兴趋势。

✨ 主要特性

• 情感分析：精准获取特定加密货币的情感平衡，对比正面与负面情绪。
• 社交量追踪：实时监控总社交媒体提及数，敏锐检测显著变化，如飙升或下降。
• 社交主导地位：精确衡量某一资产在.crypto媒体讨论中的份额占比。
• 热门词汇识别：快速识别加密货币讨论中热度最高的术语。

📚 详细文档

工具详情

| 工具名称 | 描述 | 参数 | |-------------------------|-----------------------------------------------------------------------------------------------|---------------------------------------------| | get_sentiment_balance | 获取特定资产在一个时间段内的平均情感平衡。 | asset: str, days: int = 7 | | get_social_volume | 检索特定资产在社交媒体上的总提及数。 | asset: str, days: int = 7 | | alert_social_shift | 检测社交量与之前平均值相比的显著飙升或下降。 | asset: str, threshold: float = 50.0, days: int = 7 | | get_trending_words | 检索加密货币讨论中在一定时期内按评分排序的最流行术语。 | days: int = 7, top_n: int = 5 | | get_social_dominance | 衡量一个资产在.crypto媒体讨论中的百分比份额。 | asset: str, days: int = 7 |

📦 安装指南

先决条件

• Python：需使用3.10或更高版本。
• Santiment API密钥：可从Santiment获取免费或付费密钥。

安装步骤

1. 克隆仓库：

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

2. 配置客户端：

   {
     "mcpServers": {
       "crypto-sentiment-mcp": {
         "command": "uv",
         "args": ["--directory", "path/to/crypto-sentiment-mcp", "run", "main.py"],
         "env": {
           "SANTIMENT_API_KEY": "your_api_key_here"
         }
       }
     }
   }
   

💻 使用示例

以下是与MCP兼容客户端交互的示例：

基础用法

查询比特币当前价格

输入：

{
  "id": "get_bitcoin_price",
  "method": "GET",
  "url": "http://localhost:8000/api/bitcoin/price"
}

输出：

{
  "response": {
    "price": 50, 
    "currency": "USD"
  }
}

获取以太坊的市场数据

输入：

{
  "id": "get_ethereum_data",
  "method": "GET",
  "url": "http://localhost:8000/api/ethereum/data"
}

输出：

{
  "response": {
    "symbol": "ETH",
    "price": 3.5,
    "market_cap": 1000000000,
    "volume_24h": 500000000
  }
}

监控多加密货币价格

输入：

{
  "id": "monitor_prices",
  "method": "GET",
  "url": "http://localhost:8000/api/monitor/prices"
}

输出：

{
  "response": {
    "bitcoin": { "price": 50, "change_24h": "+2.5%" },
    "ethereum": { "price": 3.5, "change_24h": "-1.5%" },
    "solana": { "price": 1.2, "change_24h": "+5.0%" }
  }
}

📄 许可证

此项目采用MIT License授权。