Financial AI Agent

📈 Aplicación de Agente con Model Context Protocol (MCP)

Un agente de IA basado en TypeScript con integración MCP. Este proyecto proporciona una interfaz unificada para acceder a información del mercado financiero y artículos de noticias relevantes a través de servidores MCP con llamadas a herramientas.

DEMO

Terminal

https://github.com/user-attachments/assets/47150b98-0663-43f6-927e-f09abb796fe6

Cursor

https://github.com/user-attachments/assets/72210b49-dc23-4bef-b7ee-6d289ede59e1

✨ Características

• 📊 Datos del Mercado de Valores:
  • Información de la empresa
  • Finanzas trimestrales
  • Informes financieros anuales
• 📰 Integración de Noticias:
  • Artículos de noticias en tiempo real
  • Búsqueda de noticias basada en consultas
• 🛠️ Componentes de Arquitectura:
  • Arquitectura cliente-servidor
  • Implementación en TypeScript
  • Patrón de diseño modular
  • Agente LangChain

🔧 Requisitos previos

• Node.js 16.x o superior
• TypeScript 4.x o superior
• Claves API para servicios de acciones y OpenAi

🚀 Inicio Rápido

1. Instalación

Clona y configura el proyecto:

git clone https://github.com/extrawest/financial-ai-agent-mcp-servers
cd  financial-ai-agent-mcp-servers

# Install dependencies
npm install

2. Configuración del Entorno

Crea un archivo .env en la raíz del proyecto:

# API Configuration
STOCK_API_KEY=your_stock_api_key
OPENAI_API_KEY=your_open_ai_key

3. Compilar y Ejecutar

# Build the project
npm run build

# Start the server
npm start

🏗️ Estructura del Proyecto

src/
├── agent/
│   └── agent.ts         # Agent implementation
├── client/
│   └── client.ts        # API client implementation
├── config/
│   └── configs.ts       # Configuration management
├── logger/
│   └── logger.ts        # Logging functionality
├── server/
│   ├── news-server.ts   # News API server
│   └── stocks-server.ts # Stock market API server
├── types/
│   └── newsapi.d.ts     # Type definitions
└── index.ts             # Application entry point

📦 Componentes Principales

Servidor de Acciones

Maneja todas las operaciones relacionadas con el mercado de valores:

• Recuperación de información de la empresa
• Acceso a informes financieros
• Procesamiento de datos de mercado

Servidor de Noticias

Gestiona la funcionalidad relacionada con noticias:

• Búsqueda y recuperación de artículos
• Procesamiento de consultas
• Formateo de datos de noticias

Cliente

Proporciona una interfaz unificada para interactuar con ambos servidores:

• Manejo de solicitudes API
• Procesamiento de respuestas
• Gestión de errores

Iniciar una aplicación

En pestañas de terminal separadas, ejecuta

# Start Stocks server
 npm run stocks:built

 # Start News server
 npm npm run news:built

  # Run agent
 npm run agent:built

Añadir MCP a Cursor IDE

• Abre Cursor IDE, ve a Configuración -> Configuración de Cursor
• Ve a la sección Herramientas e Integraciones
• Encuentra las herramientas MCP, haz clic en Nuevo Servidor MCP
• Añade esto al archivo mcp.json

{
    "mcpServers": {
        "stocks-mcp-server": {
            "url": "http://127.0.0.1:3000/sse"
        },
        "news-mcp-server": {
            "url": "http://127.0.0.1:3001/sse"
        }
    }
}

• Ejecuta comandos en pestañas de terminal separadas

# Start Stocks server
 npm run stocks:built

 # Start News server
 npm npm run news:built

📝 Licencia

Este proyecto está licenciado bajo la Licencia MIT: consulta el archivo LICENSE para más detalles.

---

Creado por Oleksandr Samoilenko
Extrawest.com, 2025