AKShare One

Accede a datos del mercado de valores chino, incluyendo precios históricos, cotizaciones en tiempo real, noticias y estados financieros.

GitHub
221

Documentación

AKShare One MCP Server

smithery badge

Resumen

Un servidor MCP basado en akshare-one, que proporciona interfaces completas para datos del mercado de valores de China. Ofrece un conjunto de herramientas potentes para recuperar información financiera, incluidos datos históricos de acciones, datos en tiempo real, datos de noticias y estados financieros.

akshare-one-mcp MCP server

Herramientas Disponibles

Herramientas de Datos de Mercado

get_hist_data

Obtiene datos históricos del mercado de valores con soporte para múltiples períodos de tiempo y métodos de ajuste.

Parámetros
  • symbol (string, obligatorio): Código de acción (p. ej., '000001')
  • interval (string, opcional): Intervalo de tiempo ('minute','hour','day','week','month','year') (predeterminado: 'day')
  • interval_multiplier (number, opcional): Multiplicador de intervalo (predeterminado: 1)
  • start_date (string, opcional): Fecha de inicio en formato YYYY-MM-DD (predeterminado: '1970-01-01')
  • end_date (string, opcional): Fecha de fin en formato YYYY-MM-DD (predeterminado: '2030-12-31')
  • adjust (string, opcional): Tipo de ajuste ('none', 'qfq', 'hfq') (predeterminado: 'none')
  • source (string, opcional): Fuente de datos ('eastmoney', 'eastmoney_direct', 'sina') (predeterminado: 'eastmoney')
  • indicators_list (list, opcional): Indicadores técnicos para agregar
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 100)

get_realtime_data

Obtiene datos del mercado de valores en tiempo real.

Parámetros
  • symbol (string, opcional): Código de acción
  • source (string, opcional): Fuente de datos ('xueqiu', 'eastmoney', 'eastmoney_direct') (predeterminado: 'eastmoney_direct')

Herramientas de Noticias e Información

get_news_data

Obtiene datos de noticias relacionadas con acciones.

Parámetros
  • symbol (string, obligatorio): Código de acción
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 10)

Herramientas de Estados Financieros

get_balance_sheet

Obtiene datos del balance general de la empresa.

Parámetros
  • symbol (string, obligatorio): Código de acción
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 10)

get_income_statement

Obtiene datos del estado de resultados de la empresa.

Parámetros
  • symbol (string, obligatorio): Código de acción
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 10)

get_cash_flow

Obtiene datos del estado de flujo de efectivo de la empresa.

Parámetros
  • symbol (string, obligatorio): Código de acción
  • source (string, opcional): Fuente de datos (predeterminado: 'sina')
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 10)

Herramientas de Análisis y Métricas

get_inner_trade_data

Obtiene datos de operaciones con información privilegiada de la empresa.

Parámetros
  • symbol (string, obligatorio): Código de acción

get_financial_metrics

Obtiene métricas financieras clave de los tres estados financieros principales.

Parámetros
  • symbol (string, obligatorio): Código de acción
  • recent_n (number, opcional): Número de registros más recientes a devolver (predeterminado: 10)

get_time_info

Obtiene la hora actual con formato ISO, la marca de tiempo y el último día de negociación.

Instalación y Configuración

Modos de Ejecución

El servidor admite dos modos: stdio y streamable-http

Argumentos de línea de comandos:

  • --streamable-http: Habilita el modo HTTP (predeterminado: modo stdio)
  • --host: Host al que vincularse en modo HTTP (predeterminado: 0.0.0.0)
  • --port: Puerto para escuchar en modo HTTP (predeterminado: 8081)

Nota: Al usar el modo streamable-http, el servidor MCP estará disponible en http://{host}:{port}/mcp. Para la configuración predeterminada, esto sería http://0.0.0.0:8081/mcp.

Opciones de Instalación

Opción 1: Mediante Smithery

Para instalar akshare-one-mcp para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude

Opción 2: Mediante uv

Instala uv si aún no lo has hecho.

Agrega la siguiente configuración a los ajustes de tu cliente MCP:

{
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uvx",
      "args": ["akshare-one-mcp"]
    }
  }
}

Opción 3: Configuración de Desarrollo Local

  1. Clona este repositorio:

    git clone https://github.com/zwldarren/akshare-one-mcp.git
cd akshare-one-mcp

  2. Instala las dependencias:

    uv sync

  3. Agrega la siguiente configuración a los ajustes de tu cliente MCP:

    {
  "mcpServers": {
    "akshare-one-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/akshare-one-mcp",
        "run",
        "akshare-one-mcp"
      ]
    }
  }
}

Referencia de Indicadores Técnicos

La herramienta get_hist_data admite los siguientes indicadores técnicos:

Indicadores de Tendencia

  • Medias móviles: SMA (media móvil simple), EMA (media móvil exponencial)
  • Seguimiento de tendencia: MACD (convergencia/divergencia de medias móviles), APO (oscilador de precio absoluto), PPO (oscilador de precio porcentual)
  • Tasa de cambio: ROC (tasa de cambio), ROCP (porcentaje de tasa de cambio), ROCR (relación de tasa de cambio), ROCR100
  • Otros: TRIX (media móvil exponencial triple), ULTOSC (oscilador definitivo)

Indicadores de Momento

  • Fuerza relativa: RSI (índice de fuerza relativa), CCI (índice de canal de materias primas)
  • Fuerza de tendencia: ADX (índice direccional promedio), DX (índice direccional)
  • Flujo de dinero: MFI (índice de flujo de dinero), MOM (momento), CMO (oscilador de momento de Chande), WILLR (Williams %R)

Indicadores de Volatilidad

  • Bandas de Bollinger: BOLL (bandas de Bollinger)
  • Rango verdadero promedio: ATR (rango verdadero promedio)
  • SAR parabólico: SAR (detención y reversión parabólica)

Indicadores de Volumen

  • Volumen: OBV (volumen de balance), AD (línea de acumulación/distribución), ADOSC (oscilador de acumulación/distribución)

Otros Indicadores

  • Estocástico: STOCH (oscilador estocástico)
  • Aroon: AROON (indicador Aroon), AROONOSC (oscilador Aroon)
  • Balance de poder: BOP (balance de poder)
  • Indicadores direccionales: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
  • Pronóstico de series temporales: TSF (pronóstico de series temporales)