Crypto Sentiment MCP Server

Crypto Sentiment MCP サーバー

Santiment の集約されたソーシャルメディアとニュースのデータを活用し、市場のムードを追跡して新たなトレンドを検出することで、AI エージェントに暗号資産のセンチメント分析を提供する MCP サーバーです。

機能

• センチメント分析：特定の暗号資産について、センチメントのバランス（ポジティブ対ネガティブ）を取得します。
• ソーシャルボリュームの追跡：ソーシャルメディアでの言及総数を監視し、大きな変化（急増または減少）を検出します。
• ソーシャルドミナンス：暗号資産メディアで、ある資産が占める議論の割合を測定します。
• トレンドワード：暗号資産に関する議論で人気の高いトレンドワードを特定します。

ツール

ツール名	説明	パラメーター
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	暗号資産メディアでの議論のうち、ある資産が占める割合を測定します。	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 対応クライアントを介してサーバーとやり取りする際の、自然言語による入力とそれに対応する出力の例です。

• 入力：「過去 1 週間の Bitcoin のセンチメントバランスは？」

  • 出力：「過去 7 日間の Bitcoin のセンチメントバランスは 12.5 です。」

• 入力：「過去 5 日間に Ethereum はソーシャルメディアで何回言及されましたか？」

  • 出力：「過去 5 日間の Ethereum のソーシャルボリュームは 8,432 件です。」

• 入力：「しきい値を 30% として、最近 Bitcoin のソーシャルボリュームに大きな変化があったか教えてください。」

  • 出力：「過去 24 時間に Bitcoin のソーシャルボリュームは 75.0% 増加し、平均 1,000 件から 1,750 件になりました。」

• 入力：「過去 3 日間の暗号資産に関する上位 3 つのトレンドワードは？」

  • 出力：「過去 3 日間の上位 3 つのトレンドワードは、「halving」、「bullrun」、「defi」です。」

• 入力：「今週、ソーシャルメディアの議論における Ethereum の優勢度はどのくらいですか？」

  • 出力：「過去 7 日間の Ethereum のソーシャルドミナンスは 18.7% です。」

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳しくは LICENSE ファイルをご覧ください。