stooq-mcp

stooq-mcp

Japonês

Um servidor Model Context Protocol (MCP) escrito em Rust que busca dados de preços de ações do stooq.com.

Demonstração

https://github.com/user-attachments/assets/63b55175-80c3-42aa-a28a-bdb21c66169e

Recursos

• Preços de ações mais recentes - Obtenha dados de preços de ações em tempo real
• Dados históricos - Recupere dados históricos de ações com intervalos de datas personalizados
• Suporte a múltiplos mercados - Acesse ações de 5 grandes mercados

Mercados Suportados

Código do Mercado	País
jp	Japão
us	Estados Unidos
uk	Reino Unido
hk	Hong Kong
de	Alemanha

Instalação

Pré-requisitos

• Rust 1.75+
• Cargo

Instalação em uma linha

curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash

Isso instalará em ~/.stooq-mcp/. Para personalizar:

STOOQ_MCP_DIR=/your/path curl -fsSL https://raw.githubusercontent.com/hoqqun/stooq-mcp/main/install.sh | bash

Instalação Rápida

git clone https://github.com/hoqqun/stooq-mcp.git
cd stooq-mcp
./install.sh

O script de instalação irá:

1. Compilar o projeto
2. Registrar com Claude Code e/ou Claude Desktop

Compilação Manual

cargo build --release

O binário estará localizado em ./target/release/stooq-mcp.

Uso

Claude Code

Registre o servidor MCP com o Claude Code:

claude mcp add stooq-mcp /path/to/stooq-mcp/target/release/stooq-mcp

Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop:

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

{
  "mcpServers": {
    "stooq-mcp": {
      "command": "/path/to/stooq-mcp/target/release/stooq-mcp"
    }
  }
}

Ferramentas

get_stock_price

Busca dados de preços de ações do stooq.com.

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
ticker	string	✅	Símbolo do ticker da ação (ex.: "7203", "AAPL")
market	string	✅	Código do mercado: jp, us, uk, hk, de
start_date	string	❌	Data de início no formato YYYYMMDD (ex.: "20240101")
end_date	string	❌	Data de término no formato YYYYMMDD (ex.: "20241231")

Exemplos

Obter preço de ação mais recente

Toyota Motor (Japão):

Get the current stock price for Toyota (7203) in Japan market.

Apple (EUA):

Get the latest AAPL stock price from US market.

Obter dados históricos

Sony (Japão) - ano completo de 2024:

Get Sony (6758) stock price history from January 1, 2024 to December 31, 2024.

Formato de resposta

Dados mais recentes:

Symbol,Date,Time,Open,High,Low,Close,Volume
7203.JP,2024-12-27,16:00:00,2500,2520,2480,2510,1000000

Dados históricos:

Date,Open,High,Low,Close,Volume
2024-01-04,2450,2480,2440,2470,800000
2024-01-05,2470,2490,2460,2485,750000
...

Pilha Tecnológica

• Rust - Linguagem de programação de sistemas
• rmcp - Implementação do servidor MCP
• reqwest - Cliente HTTP
• tokio - Runtime assíncrono

Limitações

⚠️ Aviso Importante

• stooq.com é uma API não oficial e pode mudar sem aviso prévio
• Limites diários de taxa se aplicam - solicitações excessivas podem ser bloqueadas
• Destinado apenas para uso pessoal e fins de aprendizado
• A precisão dos dados não é garantida

Licença

Licença MIT - veja LICENSE para detalhes.

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.