Servidor MCP de WSB Analyst

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona datos de WallStreetBets en tiempo real para su análisis con Claude u otros clientes LLM.

Características

Obtener publicaciones de WallStreetBets : filtrar publicaciones por puntuación, cantidad de comentarios y tipo de contenido
Análisis detallado de publicaciones : extraiga comentarios, enlaces y metadatos de las publicaciones
Recopilación de enlaces externos : recopila enlaces que se comparten en las discusiones de WSB
Plantillas de análisis : Plantillas de indicaciones listas para usar para el análisis de mercado
Informes de progreso : actualizaciones de progreso en tiempo real durante la recopilación de datos
Integración con MCP : integración perfecta con Claude Desktop y otros clientes de MCP

Requisitos

Python 3.10 o superior
Credenciales de la API de Reddit
Claude Desktop u otro cliente MCP

Instalación

Clone este repositorio o descargue los archivos fuente:

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

Cree un entorno virtual e instale dependencias:

# Using uv (recommended)
uv sync

Configuración de las credenciales de la API de Reddit

Para utilizar este servidor, debe crear una aplicación Reddit para obtener las credenciales de API:

Inicia sesión en tu cuenta de Reddit
Vaya a https://www.reddit.com/prefs/apps
Desplácese hacia abajo y haga clic en "crear otra aplicación..." o "crear una aplicación..."
Complete los siguientes datos:
- Nombre : Analista WSB MCP (o cualquier nombre que prefiera)
- Tipo de aplicación : seleccione "script"
- Descripción : Descripción opcional de su aplicación.
- Acerca de la URL : se puede dejar en blanco.
- URI de redireccionamiento : use http://localhost:8000 (cualquier URL válida funciona ya que no usamos OAuth)
Haga clic en "crear aplicación"
Después de la creación, anote:
- client_id : La cadena debajo del nombre de la aplicación (aparece justo debajo de "script de uso personal")
- client_secret : La cadena etiquetada como "secreto"

Configuración para Claude Desktop

Abra el archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Ventanas: %APPDATA%\Claude\claude_desktop_config.json

Agregue la siguiente configuración (ajuste las rutas según sea necesario):

{
  "mcpServers": {
    "wsb-analyst": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/wsb-analyst-mcp",
        "run",
        "mcp_wsb_server.py"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id_here",
        "REDDIT_CLIENT_SECRET": "your_client_secret_here"
      }
    }
  }
}

Reiniciar Claude Desktop

Uso con Claude Desktop

Una vez configurado, puedes interactuar con el servidor WSB Analyst a través de Claude:

Abra Claude Desktop
Debería ver un icono de martillo en la esquina inferior derecha del cuadro de entrada del mensaje.
Haga clic en el martillo para ver las herramientas disponibles.
Acceda a las plantillas de solicitud mediante comandos de barra (por ejemplo, /analyze_wsb_market )

Consultas de ejemplo:

"¿Cuáles son las acciones con mayor tendencia hoy en WallStreetBets?"
Analice las publicaciones recientes de WallStreetBets y cuénteme sobre posibles oportunidades de mercado.
"¿Qué recursos externos comparten los usuarios de WSB sobre las acciones de AMD?"

Herramientas disponibles

`find_top_posts`

Obtener y filtrar publicaciones de WSB según criterios.

Parámetros:

min_score (predeterminado: 100): Puntuación mínima (votos positivos) requerida
min_comments (predeterminado: 10): Número mínimo de comentarios requeridos
limit (predeterminado: 10): número máximo de publicaciones a devolver
excluded_flairs (predeterminado: ["Meme", "Shitpost", "Gain", "Loss"] ): Lista de etiquetas de publicaciones para excluir.

`fetch_post_details`

Obtenga información detallada sobre una publicación específica de WSB, incluidos los comentarios principales.

Parámetros:

post_id : ID de publicación de Reddit

`fetch_batch_post_details`

Obtiene detalles de múltiples publicaciones de manera eficiente.

`fetch_detailed_wsb_posts`

Obtenga y filtre las publicaciones de WSB, luego obtenga información detallada, incluidos los principales comentarios y enlaces para cada una.

`get_external_links`

Recopila todos los enlaces externos de las publicaciones principales.

`get_trending_tickers`

Identifica y devuelve una lista de cotizaciones bursátiles mencionadas o discutidas con frecuencia en publicaciones recientes de WSB.

Plantillas de indicaciones

`/analyze_wsb_market`

Proporciona una plantilla de instrucciones para guiar al estudiante de maestría en la realización de un análisis de mercado exhaustivo utilizando las herramientas disponibles ( fetch_detailed_wsb_posts , get_external_links ). Indica al estudiante la estructura y el enfoque del análisis.

`/find_market_movers`

Crea una indicación enfocada en los factores que impulsan acciones específicas o el mercado en general. Esta indicación guía al LLM para usar herramientas como find_top_posts , fetch_post_details o fetch_batch_post_details .

Integración con el servidor MCP de Firecrawl

Para mejorar las capacidades de análisis, especialmente al gestionar enlaces externos en publicaciones de WSB, puede integrar este servidor con el servidor Firecrawl MCP . Esto permite a su agente LLM no solo identificar enlaces compartidos en WSB, sino también extraer y analizar el contenido de esas páginas enlazadas.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

WSB Analyst MCP Server

Integrations