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 许可证。