lit-forge-mcp

Servidor MCP lit-forge

Simulación de formación de activos personales, instantánea de los principales mercados, calendario de indicadores económicos, declaraciones de altos funcionarios de bancos centrales y eventos geopolíticos que se pueden invocar directamente desde IA mediante un servidor stdio de Model Context Protocol (MCP) (19 herramientas).

Funciona con cualquier cliente compatible con MCP, como Claude Desktop / Claude Code / Cursor, etc.

Aspectos destacados de la última versión (v0.20.0): Se ha añadido un adaptador en vivo de ForexFactory a get_economic_release_pulse. Se añade mediante obtención dinámica el número de ofertas de empleo JOLTS de EE. UU. (que antes se omitía porque no estaba incluido en PFEI), y además se sustituye el PMI flash de S&P Global de transcripción manual estática por obtención en vivo (se elimina la actualización manual semestral). También se añaden en vivo a pulse ISM manufacturero/no manufacturero, confianza del consumidor (CB/Universidad de Míchigan) y empleo ADP. En las fechas de publicación, el calendario semanal XML de faireconomy se obtiene en tiempo de ejecución, por lo que no es necesario añadir manualmente fechas futuras. La conversión GMT→JST también es precisa para cambios de día. ※ Los tres indicadores principales de BLS (informe de empleo, IPC e IPP) mantienen como fuente oficial primaria el PFEI.

v0.19.0: Se añade a get_economic_release_pulse el Informe de Indicadores Económicos Anticipados de la Oficina del Censo de EE. UU. (U.S. Census Bureau) (inventarios mayoristas, inventarios minoristas y balanza comercial de bienes, valores preliminares, mensual a las 08:30 ET), resolviendo la brecha de cobertura de indicadores como «inventarios mayoristas de EE. UU. [valor preliminar]» que ningún adaptador anterior podía captar. En las fechas de publicación, el calendario oficial de lanzamientos (vista de lista) se obtiene en vivo en tiempo de ejecución, por lo que los calendarios de años posteriores también siguen las actualizaciones de la página oficial (sin actualización manual).

v0.18.0: Se añade la nueva herramienta get_central_bank_speakers. Se obtienen en vivo las declaraciones y discursos próximos de altos funcionarios de bancos centrales (gobernadores de la Fed, presidentes de bancos regionales de la Fed, BOJ, BCE, BOE, etc.) desde el calendario gratuito de ForexFactory, y para la Fed de EE. UU. se complementa con el cargo (presidente del Banco de la Reserva Federal de Dallas, etc.) y si tiene o no derecho a voto según la lista de miembros del FOMC del año en curso. Las declaraciones de los miembros con derecho a voto aumentan su importancia (presidente=★★★ / miembros con voto=★★ o más). ※ La categoría estática centralbank que se introdujo temporalmente en get_economic_events_today en v0.17.0 se unifica en esta herramienta (se elimina).

v0.16.0: Se añaden a get_economic_events_today (calendario económico de curación manual) el Índice de Confianza del Consumidor de EE. UU. (Conference Board, último martes de cada mes) y el Índice de Sentimiento del Consumidor de la Universidad de Míchigan (preliminar=segundo viernes / final=cuarto viernes). Se cubren los indicadores de sentimiento del consumidor estadounidense de alta relevancia para el mercado de divisas.

v0.15.0: Se añaden a get_economic_release_pulse las solicitudes iniciales de subsidio de desempleo del DOL/ETA (semanal, cada jueves a las 08:30 ET) y el PMI flash de S&P Global de EE. UU. (manufacturero/de servicios flash, 09:45 ET), resolviendo las brechas de cobertura que antes se omitían.

v0.14.0: Se integra el Calendario PFEI (Principal Federal Economic Indicators) de la OMB/OIRA de la Casa Blanca, y las fechas de publicación de los tres indicadores principales de BLS (informe de empleo, IPC e IPP) pasan a obtenerse automáticamente. Además, get_us_macro_latest se amplía de 4 a 7 series (se añaden IPC subyacente / IPP subyacente / salario promedio por hora).

En conversaciones con Claude / GPT / Cursor, se pueden responder en un solo turno preguntas como las siguientes:

• «¿Me alcanza para la jubilación?» «¿Cuánto debo aportar al mes para llegar a 20 millones de yenes?»
• «Resume el estado del mercado de hoy con 28 indicadores» «¿Qué sector está más fuerte?»
• «¿Cuándo es el próximo informe de empleo?» «Resume las publicaciones de la Fed de este mes»
• «¿Cuál es la variación interanual más reciente del IPC y del IPP?» «Compara el IPC subyacente y el IPP subyacente»
• «¿Cuándo es la cumbre del G7 de este mes?» «¿Cuáles son los titulares actuales sobre la situación en Irán?»

Herramientas disponibles (18 tipos)

Planificador de formación de activos personales (funciones puras, sin API externa) — 4 herramientas

Grupo de simulaciones de interés compuesto mensual para tsumitate NISA / iDeCo / planificación de jubilación.

Nombre de la herramienta	Descripción
simulate_nisa	Calcula el valor estimado, las ganancias de inversión y la evolución anual con interés compuesto mensual a partir del monto de aportación mensual, la tasa de interés anual estimada y el número de años
plan_retirement	Diagnostica la suficiencia de los fondos de jubilación en 3 escenarios (optimista/realista/pesimista) a partir de edad, ahorros, ingresos, gasto de vida deseado, tolerancia al riesgo y pensión + cálculo inverso del monto mensual necesario
calculate_required_monthly	Calcula inversamente el monto de aportación mensual necesario para alcanzar el objetivo a partir del monto objetivo, los ahorros actuales, la tasa de interés anual y el número de años
calculate_compound_interest	Herramienta de cálculo de interés compuesto general que evalúa el capital (suma global) y las aportaciones mensuales con interés compuesto mensual

Instantánea del mercado y acciones individuales — 2 herramientas

Nombre de la herramienta	Descripción
get_market_snapshot	Obtiene de una sola vez los 28 indicadores principales: USD/JPY, EUR/JPY, GBP/JPY, AUD/JPY, EUR/USD, CHF/JPY, índice del dólar, Nikkei 225, TOPIX, Dow Jones de NY, S&P 500, NASDAQ, VIX, NYSE FANG+, SOX, DAX, FTSE, Shanghai Composite, Hang Seng, KOSPI, SENSEX, bonos de EE. UU. a 10/5 años, oro, petróleo crudo, cobre, bitcoin y ethereum
get_quote	Obtiene el valor actual y la variación diaria de cualquier ticker de Yahoo Finance (acciones, divisas, índices, materias primas, criptoactivos). Ejemplos: AAPL / ^DJI / BTC-USD. Con includeFundamentals: true también se obtienen PER / PBR / rendimiento de dividendos / beta / capitalización de mercado

Panorama del mercado — 5 herramientas

Nombre de la herramienta	Descripción
get_market_thermometer	Puntuación de riesgo on/off de 0 a 100 que combina VIX, S&P 500, bono de EE. UU. a 10 años e índice del dólar + evolución de los últimos 30 días hábiles
get_performance_ranking	Ordena 28 tickers por rendimiento de 1d/1w/1m y devuelve los N primeros/últimos
get_yield_spread	Diferencial de rendimiento entre el bono de EE. UU. a 10 años y a 5 años (positivo=curva normal / negativo=curva invertida)
get_market_sessions	Estado actual del horario de negociación de los 4 principales mercados (Tokio, Shanghái, Londres y NY) (open / pre-open / closed / holiday, con soporte para días festivos)
get_sector_heatmap	Lista de variación diaria de los ETF sectoriales de acciones de EE. UU. (SPDR, 11 sectores)

Análisis profundo de acciones individuales — 2 herramientas

Nombre de la herramienta	Descripción
get_dividend_history	Obtiene el historial de dividendos de los últimos N años y el total por año calendario de acciones individuales y ETF (years: 1/3/5/10, predeterminado 5). Se utiliza como información primaria para considerar acciones con dividendos en el marco de crecimiento de inversión NISA
get_analyst_consensus	Obtiene las calificaciones recomendadas de analistas (compra fuerte a venta fuerte), el precio objetivo (promedio/máximo/mínimo) y el desglose mensual de recomendaciones de acciones individuales. Las acciones de EE. UU. tienen una cobertura amplia; los tickers de TSE y los ETF tienden a tener datos faltantes

Eventos económicos, declaraciones de bancos centrales y valores macro recientes — 4 herramientas

Se reparten las funciones de «cuándo se publicará a continuación» (2 de calendario), «quién habla y cuándo» (1 de declaraciones) y «cuál es el valor actual» (1 de valores recientes).

Nombre de la herramienta	Descripción
get_economic_events_today	Devuelve los eventos económicos del día o de la semana (FOMC, reunión de política monetaria del BOJ, informe de empleo de EE. UU., IPC, PIB, índice de confianza del consumidor de EE. UU. (CB / Universidad de Míchigan), PMI de China, etc.) con nivel de importancia. Se puede filtrar con category a macro / geopolitical / policy. Los eventos de varios días (como la reunión de Jackson Hole) se manejan con endDate. Curación manual de medio año. Para declaraciones de altos funcionarios de bancos centrales, use get_central_bank_speakers
get_central_bank_speakers	Obtiene en vivo las próximas declaraciones y discursos de altos funcionarios de bancos centrales: extrae eventos de declaraciones (gobernadores de la Fed, presidentes de bancos regionales, BOJ, BCE, BOE, etc.) del calendario gratuito de ForexFactory. Para la Fed de EE. UU., complementa con role (presidente del Banco de la Reserva Federal de Dallas, etc.) / votingMember (si tiene o no derecho a voto) según la lista de miembros del FOMC del año en curso, y los miembros con derecho a voto aumentan su importancia (presidente=★★★ / miembros con voto=★★ o más). Filtro con range (today/week) y countries (US/JP/EU/GB/CN/OTHER). Caché de 6 horas
get_economic_release_pulse	Obtiene realmente los calendarios de publicación de organismos oficiales: obtiene en paralelo los calendarios de BEA / NY Fed / FRB / BLS (a través de PFEI) / DOL/ETA (solicitudes iniciales de subsidio de desempleo) / ForexFactory en vivo (ofertas de empleo JOLTS, PMI flash manufacturero/de servicios, ISM manufacturero/no manufacturero, confianza del consumidor [CB/Universidad de Míchigan], empleo ADP) / Oficina del Censo (inventarios mayoristas, inventarios minoristas y balanza comercial de bienes, valores preliminares) / Oficina del Gabinete / BOJ, y devuelve de forma integrada los calendarios de publicación de indicadores económicos de hoy, esta semana y este mes. Los tres indicadores principales de BLS se integraron con el Calendario PFEI en v0.14.0, los Indicadores Económicos Anticipados de la Oficina del Censo se añadieron en v0.19.0, y en v0.20.0 se creó el adaptador en vivo de ForexFactory (adición de JOLTS, PMI flash de S&P en vivo, adición de ISM/confianza del consumidor/ADP)
get_us_macro_latest	Valores publicados más recientes de las 7 series macro de EE. UU.: obtiene informe de empleo, tasa de desempleo, IPC, IPC subyacente, IPP, IPP subyacente y salario promedio por hora en una sola solicitud desde la API pública de datos de BLS v2. Devuelve el valor + variación mensual + variación interanual. Sin necesidad de clave API, 25 solicitudes diarias sin autenticación, caché de 6 horas

Geopolítica — 2 herramientas

Dos sistemas: calendario de eventos confirmados y noticias de última hora en tiempo real (pulse).

Nombre de la herramienta	Descripción
get_geopolitical_calendar	Calendario oficial confirmado: devuelve los eventos geopolíticos de hoy, esta semana y este mes en 4 subcategorías (summit / bilateral / election / risk). Con marketImplications / participants / sourceUrl. Datos estáticos actualizados manualmente mediante PR una vez cada seis meses
get_geopolitical_pulse	Noticias de última hora en tiempo real: obtiene en paralelo los RSS de BBC World, Al Jazeera y Google News (búsqueda por tema) y devuelve los eventos geopolíticos en curso (reuniones de líderes, conflictos, sanciones, escenarios de bloqueo, etc.) en orden cronológico inverso. topic: us-china / middle-east / ukraine / japan / global. Solo metadatos de artículos (título, fuente, fecha de publicación, URL); la interpretación es responsabilidad del LLM que realiza la llamada

Sobre la comunicación HTTP

Las herramientas de mercado, análisis y acciones individuales envían solicitudes HTTPS a Yahoo Finance API (query1.finance.yahoo.com / query2.finance.yahoo.com), get_us_macro_latest a BLS Public Data API v2 (api.bls.gov), get_economic_release_pulse a las páginas de calendario de cada organismo oficial, get_geopolitical_pulse a los RSS de BBC / Al Jazeera / Google News, y get_central_bank_speakers a el calendario gratuito de ForexFactory (nfs.faireconomy.media). Tenga en cuenta que se generará tráfico de salida desde la red de la PC donde se ejecute.

Los datos son valores de referencia con un retraso de decenas de minutos a 1 hora y se proporcionan como agregación de información, no como asesoramiento de inversión.

Los fundamentals de get_quote / get_dividend_history / get_analyst_consensus pasan por Yahoo Finance v10 quoteSummary (con autenticación crumb), por lo que se utiliza yahoo-finance2 como paquete dependiente.

Instalación / Configuración

Para Claude Desktop

Añada lo siguiente a claude_desktop_config.json.

{
  "mcpServers": {
    "lit-forge": {
      "command": "npx",
      "args": ["-y", "lit-forge-mcp@latest"]
    }
  }
}

Ubicación del archivo de configuración:

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

Para Claude Code

claude mcp add lit-forge -- npx -y lit-forge-mcp@latest

Para Cursor

Añada el mismo JSON a ~/.cursor/mcp.json (o a .cursor/mcp.json en la raíz del proyecto).

💡 Sobre la especificación de @latest

En los ejemplos de configuración anteriores se especifica lit-forge-mcp@latest en todos los casos. Esto se debe a que, debido al comportamiento de caché de npx, si no se especifica una versión, se puede seguir usando una versión antigua en caché. Al especificar @latest, se verifica y obtiene la última etiqueta del registro npm en cada inicio (la sobrecarga de resolución de versión es mínima).

Si ya está operando con lit-forge-mcp (sin especificar versión), pruebe una de las siguientes opciones para incorporar nuevas funciones y correcciones de errores:

1. Cambie la configuración a lit-forge-mcp@latest (solución permanente, recomendada)
2. Limpie la caché de npx: npx clear-npx-cache o elimine manualmente ~/.npm/_npx/
3. Cierre por completo el cliente MCP (como Claude Desktop) y reinícielo

Desarrollo local

git clone https://github.com/noblabs/lit-forge-mcp.git
cd lit-forge-mcp
npm install
npm run build
node dist/index.js   # stdio で起動

Verificación de funcionamiento

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js

Si en la respuesta de tools/list aparecen 18 herramientas, el funcionamiento es correcto.

Ejemplos de uso

Puede hacer solicitudes como las siguientes a Claude:

Planificación de formación de activos

• «Tengo 35 años y estoy aportando 30 000 yenes al mes. Ahorros actuales de 5 millones, jubilación a los 65, gasto de vida mensual deseado de 250 000 yenes. ¿Me alcanza para la jubilación?»
• «Quiero acumular 20 millones en 20 años. Si tengo 5 millones ahora y una tasa anual del 4 %, ¿cuánto debo aportar al mes?»
• «¿Cuánto serán 1 millón de yenes con interés compuesto al 5 % anual durante 30 años?»
• «¿Cuánto acumulo si aporto 30 000 yenes al mes al 6 % anual durante 20 años?»

Instantánea del mercado

• «Resume el estado del mercado de hoy» «Muéstrame la variación diaria de los principales indicadores en una tabla»
• «Comenta el nivel actual de riesgo on/off a partir del movimiento del bono de EE. UU. a 10 años y el Nikkei 225»
• «¿Cuál es el valor actual de BTC-USD?» «Dime el GBP/JPY (GBPJPY=X)»

Análisis profundo de acciones individuales

• «Muéstrame la evolución de dividendos de KO en los últimos 10 años» «¿Cuál es el total de dividendos anuales de VYM?»
• «¿Cuál es el precio objetivo de los analistas y la calificación recomendada de NVDA?»
• «Resume el PER / PBR / rendimiento de dividendos / beta de AAPL» (con get_quote y includeFundamentals=true)

Calendario de indicadores económicos y valores recientes

• «¿Cuáles son los eventos económicos de esta semana? Especialmente los planes del FOMC y del BOJ»
• «¿Cuándo es el próximo informe de empleo?» «Resume las publicaciones de la Fed y de la Oficina del Gabinete de este mes»
• «Dame el IPC y el IPP más recientes con variación mensual e interanual» «Compara el IPC subyacente y el IPP subyacente»

Declaraciones de altos funcionarios de bancos centrales

• «¿Qué declaraciones de la Fed hay hoy? Solo las de quienes tienen derecho a voto» «Lista de oradores de bancos centrales de esta semana» (get_central_bank_speakers)
• «¿Hay declaraciones programadas de Lagarde del BCE o del BOJ esta semana?» (filtrar con countries=["EU","JP"])

Eventos geopolíticos

• «¿Cuáles son los eventos geopolíticos de esta semana?» «¿Cuál es el plan de la cumbre del G7 de este mes?»
• «¿Cuándo es la próxima reunión de líderes entre EE. UU. y China?» «Extrae solo las reuniones de líderes relacionadas con Japón» (filtrar con country=["JP"])
• «¿Cuáles son los titulares actuales sobre la situación en Irán?» «¿Cuáles son las últimas noticias sobre la paz en Ucrania?»

Exención de responsabilidad sobre decisiones de inversión

Todos los cálculos de esta herramienta son valores de referencia basados en interés compuesto mensual. No se garantizan los resultados reales de la inversión (fluctuaciones del mercado, impuestos, comisiones, tipos de cambio). No se trata de una recomendación de productos financieros específicos; las decisiones de inversión son responsabilidad del propio usuario.

La estimación del monto de la pensión pública se basa en valores estándar del seguro de pensiones de bienestar (kosei nenkin). Para conocer el monto estimado exacto, consulte Nenkin Net.

Licencia

MIT