stooq-mcp

stooq-mcp

日本語

Un servidor MCP (Model Context Protocol) escrito en Rust que obtiene datos de precios de acciones de stooq.com.

Demo

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

Características

• Precios de acciones en tiempo real - Obtén datos de precios de acciones en tiempo real
• Datos históricos - Recupera datos históricos de acciones con rangos de fechas personalizados
• Soporte multi-mercado - Accede a acciones de 5 mercados principales

Mercados Soportados

Código de Mercado	País
jp	Japón
us	Estados Unidos
uk	Reino Unido
hk	Hong Kong
de	Alemania

Instalación

Requisitos previos

• Rust 1.75+
• Cargo

Instalación en una línea

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

Esto instalará en ~/.stooq-mcp/. Para personalizar:

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

Instalación rápida

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

El script de instalación:

1. Compilará el proyecto
2. Se registrará con Claude Code y/o Claude Desktop

Compilación manual

cargo build --release

El binario se ubicará en ./target/release/stooq-mcp.

Uso

Claude Code

Registra el servidor MCP con Claude Code:

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

Claude Desktop

Agrega lo siguiente a tu archivo de configuración de 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"
    }
  }
}

Herramientas

get_stock_price

Obtiene datos de precios de acciones de stooq.com.

Parámetros

Parámetro	Tipo	Requerido	Descripción
ticker	string	✅	Símbolo de la acción (ej., "7203", "AAPL")
market	string	✅	Código de mercado: jp, us, uk, hk, de
start_date	string	❌	Fecha de inicio en formato YYYYMMDD (ej., "20240101")
end_date	string	❌	Fecha de fin en formato YYYYMMDD (ej., "20241231")

Ejemplos

Obtener el último precio de la acción

Toyota Motor (Japón):

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

Apple (EE. UU.):

Get the latest AAPL stock price from US market.

Obtener datos históricos

Sony (Japón) - año completo 2024:

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

Formato de respuesta

Datos más recientes:

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

Datos históricos:

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

Stack Tecnológico

• Rust - Lenguaje de programación de sistemas
• rmcp - Implementación del servidor MCP
• reqwest - Cliente HTTP
• tokio - Runtime asíncrono

Limitaciones

⚠️ Aviso importante

• stooq.com es una API no oficial y puede cambiar sin previo aviso
• Se aplican límites de tasa diarios - las solicitudes excesivas pueden ser bloqueadas
• Está destinado solo para uso personal y fines de aprendizaje
• No se garantiza la precisión de los datos

Licencia

Licencia MIT - consulta LICENSE para más detalles.

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).