Wsb Analyst MCP

🚀 WSB 分析師 MCP 服務器

一個模型上下文協議（MCP）服務器，提供即時華爾街賭注（WSB）數據以供分析，可與Claude或其他LLM客戶端搭配使用，助力用戶高效開展金融市場分析。

🚀 快速開始

此模型上下文協議（MCP）服務器可提供即時華爾街賭注（WSB）數據用於分析，適合與Claude或其他LLM客戶端配合使用。您可通過以下步驟快速開啟使用：

1. 滿足安裝要求，包括Python 3.12及以上版本、Reddit API憑證以及Claude Desktop或其他MCP客戶端。
2. 完成安裝和配置，如通過Smithery自動安裝或手動克隆倉庫、創建虛擬環境並安裝依賴項，同時設置好Reddit API憑證和環境變量。
3. 將其與Claude Desktop集成，即可開始使用服務器提供的各項功能。

✨ 主要特性

• 抓取 WSB 帖子：可按得分、評論數和內容類型篩選帖子，精準定位所需信息。
• 詳細帖子分析：能從帖子中提取評論、鏈接和元數據，深入瞭解帖子詳情。
• 外部鏈接收集：獲取WSB討論中標註的共享鏈接，拓展信息來源。
• 分析模板：提供用於市場分析的現成提示模板，方便進行市場分析。
• 進度報告：在數據收集過程中提供即時進度更新，讓您隨時掌握數據收集情況。
• MCP 集成：與Claude Desktop和其他MCP客戶端無縫集成，使用便捷。

📦 安裝指南

通過 Smithery 安裝

要通過Smithery自動安裝 WSB 分析師以用於Claude Desktop，可執行以下命令：

npx -y @smithery/cli install @ferdousbhai/wsb-analyst-mcp --client claude

手動安裝

克隆此倉庫或下載源文件：

git clone https://github.com/ferdousbhai/wsb-analyst-mcp
cd wsb-analyst-mcp

創建虛擬環境並安裝依賴項：

# 使用uv（推薦）
uv sync

設置 Reddit API 憑證

要使用此服務器，您需要創建一個Reddit應用程序以獲取API憑證，具體步驟如下：

1. 登錄到您的Reddit賬戶。
2. 瀏覽至https://www.reddit.com/prefs/apps。
3. 滾動到底部並點擊“創建另一個應用...”或“創建應用”。
4. 填寫應用信息，特別是回調URL部分，然後保存設置。
5. 進入您的應用設置，找到並複製client_id和client_secret。

配置

將以下憑據添加到項目根目錄中的.env文件中：

REDDIT_CLIENT_ID=your_client_id_here
REDDIT_CLIENT_SECRET=your_client_secret_here

確保在運行服務器之前已配置好這些環境變量。

💻 使用示例

與 Claude Desktop 的集成

安裝完成後，您可以通過以下步驟將WSB 分析師MCP服務器與Claude Desktop集成：

1. 打開Claude Desktop。
2. 進入“設置” > “MCP 服務器”。
3. 添加新的MCP服務器，並輸入以下信息：
   • 名稱：WSB 分析師
   • 類型：MCP Server
   • 地址：http://localhost:YOUR_PORT（請根據實際端口填寫）
4. 保存設置並啟動該MCP服務器。

功能概述

工具

• find_top_posts：查找指定 subreddit 的頂級帖子。

# 示例代碼（假設存在相應的調用方式）
result = find_top_posts('your_subreddit')

• fetch_post_details：獲取單個帖子的詳細信息，包括評論、點贊數和分享鏈接。

# 示例代碼（假設存在相應的調用方式）
post_info = fetch_post_details('post_id')

• get_trending_topics：獲取當前在 WSB 上討論最熱烈的主題或股票。

# 示例代碼（假設存在相應的調用方式）
trending_topics = get_trending_topics()

提示模板

/analyze_wsb_market

提供一個提示模板，指導LLM使用可用工具（fetch_detailed_wsb_posts, get_external_links）進行全面的市場分析。它指示LLM分析結構和重點。

# 示例代碼（假設存在相應的調用方式）
analysis_result = LLM('/analyze_wsb_market')

/find_market_movers

創建一個專注於特定股票或整體市場的提示。該提示指導LLM使用工具如 find_top_posts 和 fetch_post_details 或 fetch_batch_post_details。

# 示例代碼（假設存在相應的調用方式）
market_movers = LLM('/find_market_movers')

與 Firecrawl MCP 服務器集成

為了增強分析功能，尤其是當處理WSB帖子中標註的外部鏈接時，您可以將此服務器與Firecrawl MCP Server集成。這樣可以讓您的LLM代理不僅識別WSB中的鏈接，還可以抓取和分析這些鏈接頁面的內容。

# 示例代碼（假設存在相應的調用方式）
integrated_analysis = integrate_with_firecrawl()

📚 詳細文檔

提示模板說明

/analyze_wsb_market

此提示模板用於指導LLM進行全面的市場分析，它會指示LLM使用fetch_detailed_wsb_posts和get_external_links等工具，分析市場結構和重點。

/find_market_movers

該提示專注於特定股票或整體市場，指導LLM使用find_top_posts、fetch_post_details或fetch_batch_post_details等工具，幫助找出市場中的活躍因素。

與其他服務器集成

與Firecrawl MCP Server集成後，可增強對WSB帖子中標註的外部鏈接的處理能力，使LLM代理不僅能識別鏈接，還能抓取和分析鏈接頁面的內容。

📄 許可證

本項目採用 MIT 許可證。