Financial AI Agent

📈 Model Context Protocol(MCP) Aplicativo de Agente

Um agente de IA baseado em TypeScript com integração MCP. Este projeto fornece uma interface unificada para acessar informações do mercado financeiro e artigos de notícias relevantes por meio de servidores MCP com chamada de ferramentas.

Demonstração

Terminal

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

Cursor

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

✨ Recursos

• 📊 Dados do Mercado de Ações:
  • Informações da Empresa
  • Demonstrações Financeiras Trimestrais
  • Relatórios Financeiros Anuais
• 📰 Integração de Notícias:
  • Artigos de Notícias em Tempo Real
  • Busca de Notícias Baseada em Consultas
• 🛠️ Componentes da Arquitetura:
  • Arquitetura Cliente-Servidor
  • Implementação em TypeScript
  • Padrão de Design Modular
  • agente LangChain

🔧 Pré-requisitos

• Node.js 16.x ou superior
• TypeScript 4.x ou superior
• Chaves de API para serviços de ações e OpenAi

🚀 Início Rápido

1. Instalação

Clone e configure o projeto:

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

# Install dependencies
npm install

2. Configuração do Ambiente

Crie um arquivo .env na raiz do projeto:

# API Configuration
STOCK_API_KEY=your_stock_api_key
OPENAI_API_KEY=your_open_ai_key

3. Compilar e Executar

# Build the project
npm run build

# Start the server
npm start

🏗️ Estrutura do Projeto

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 Principais

Servidor de Ações

Lida com todas as operações relacionadas ao mercado de ações:

• Recuperação de informações da empresa
• Acesso a relatórios financeiros
• Processamento de dados de mercado

Servidor de Notícias

Gerencia funcionalidades relacionadas a notícias:

• Busca e recuperação de artigos
• Processamento de consultas
• Formatação de dados de notícias

Cliente

Fornece uma interface unificada para interagir com ambos os servidores:

• Tratamento de requisições de API
• Processamento de respostas
• Gerenciamento de erros

Iniciar um aplicativo

Em abas de terminal separadas, execute

# Start Stocks server
 npm run stocks:built

 # Start News server
 npm npm run news:built

  # Run agent
 npm run agent:built

Adicionar MCP ao Cursor IDE

• Abra o Cursor IDE, vá para Configurações -> Configurações do Cursor
• Vá para a seção Ferramentas e Integrações
• Encontre as ferramentas MCP, clique em Novo Servidor MCP
• Adicione isso ao arquivo 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"
        }
    }
}

• Execute comandos em abas de terminal separadas

# Start Stocks server
 npm run stocks:built

 # Start News server
 npm npm run news:built

📝 Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

---

Criado por Oleksandr Samoilenko
Extrawest.com, 2025