AKShare One

Servidor MCP AKShare One

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.

Herramientas disponibles

Respaldo automático de fuentes

Excepto get_news_data y get_inner_trade_data, cuyas fuentes ascendentes exponen una única fuente, cada herramienta acepta un parámetro source para la fuente de datos preferida y un parámetro fallback (activado por defecto) que decide si se prueban las otras fuentes del mismo dominio cuando esa fuente genera un error o devuelve un marco vacío:

Dominio	Orden de prueba
Histórico	eastmoney → eastmoney_direct → sina
Tiempo real	eastmoney_direct → eastmoney → xueqiu (se omite cuando no se proporciona ningún símbolo)
Estados financieros	sina ⇄ eastmoney_direct

El source solicitado siempre se prueba primero; el orden solo rige el respaldo. Debido a que akshare-one proyecta cada fuente en las columnas declaradas de su dominio, el respaldo no puede cambiar los nombres de los campos ni su orden. Cuando todas las fuentes fallan, el error enumera cada una y el motivo del fallo; cuando todas las fuentes tienen éxito pero no tienen datos, se devuelve un resultado vacío. Establezca fallback en false para fijar una única fuente; en ese caso, un fallo se muestra directamente, lo que resulta útil cuando necesita saber exactamente de dónde provienen los números.

La fuente que realmente atendió una llamada se registra en el registrador akshare_one_mcp.providers.

Herramientas de datos de mercado

get_hist_data

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

Parámetros

• symbol (cadena, obligatorio): Código de la acción (p. ej., '000001')
• interval (cadena, opcional): Intervalo de tiempo ('minute','hour','day','week','month','year') (predeterminado: 'day')
• interval_multiplier (número, opcional): Multiplicador de intervalo (predeterminado: 1)
• start_date (cadena, opcional): Fecha de inicio en formato AAAA-MM-DD (predeterminado: '1970-01-01')
• end_date (cadena, opcional): Fecha de fin en formato AAAA-MM-DD (predeterminado: '2030-12-31')
• adjust (cadena, opcional): Tipo de ajuste ('none', 'qfq', 'hfq') (predeterminado: 'none')
• source (cadena, opcional): Fuente de datos ('eastmoney', 'eastmoney_direct', 'sina') (predeterminado: 'eastmoney')
• fallback (booleano, opcional): Probar 'eastmoney', 'eastmoney_direct' y 'sina' en orden cuando la fuente elegida falla o no tiene datos (predeterminado: true)
• indicators_list (lista, opcional): Indicadores técnicos que se agregarán
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 100)

get_realtime_data

Obtenga datos del mercado de valores en tiempo real.

Parámetros

• symbol (cadena, opcional): Código de la acción
• source (cadena, opcional): Fuente de datos ('eastmoney_direct', 'eastmoney', 'xueqiu') (predeterminado: 'eastmoney_direct')
• fallback (booleano, opcional): Probar 'eastmoney_direct', 'eastmoney' y 'xueqiu' en orden cuando la fuente elegida falla o no tiene datos (predeterminado: true; 'xueqiu' se omite cuando no se proporciona ningún símbolo, ya que cotiza un símbolo a la vez)

Herramientas de noticias e información

get_news_data

Obtenga datos de noticias relacionados con acciones.

Parámetros

• symbol (cadena, obligatorio): Código de la acción
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 10)

Herramientas de estados financieros

get_balance_sheet

Obtenga datos del balance general de la empresa.

Parámetros

• symbol (cadena, obligatorio): Código de la acción
• source (cadena, opcional): Fuente de datos ('sina', 'eastmoney_direct') (predeterminado: 'sina')
• fallback (booleano, opcional): Probar la otra fuente cuando la elegida falla o no tiene datos (predeterminado: true)
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 10)

get_income_statement

Obtenga datos del estado de resultados de la empresa.

Parámetros

• symbol (cadena, obligatorio): Código de la acción
• source (cadena, opcional): Fuente de datos ('sina', 'eastmoney_direct') (predeterminado: 'sina')
• fallback (booleano, opcional): Probar la otra fuente cuando la elegida falla o no tiene datos (predeterminado: true)
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 10)

get_cash_flow

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

Parámetros

• symbol (cadena, obligatorio): Código de la acción
• source (cadena, opcional): Fuente de datos ('sina', 'eastmoney_direct') (predeterminado: 'sina')
• fallback (booleano, opcional): Probar la otra fuente cuando la elegida falla o no tiene datos (predeterminado: true)
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 10)

Herramientas de análisis y métricas

get_inner_trade_data

Obtenga datos de operaciones de información privilegiada de la empresa.

Parámetros

• symbol (cadena, obligatorio): Código de la acción

get_financial_metrics

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

Parámetros

• symbol (cadena, obligatorio): Código de la acción
• source (cadena, opcional): Fuente de datos ('sina', 'eastmoney_direct') (predeterminado: 'eastmoney_direct')
• fallback (booleano, opcional): Probar la otra fuente cuando la elegida falla o no tiene datos (predeterminado: true)
• recent_n (número, opcional): Número de registros más recientes que se devolverán (predeterminado: 10)

get_time_info

Obtenga la hora actual con formato ISO, 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: Habilitar 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

Instale uv si aún no lo ha hecho.

uvx instala el paquete desde PyPI y lo ejecuta en Python 3.12 o superior.

Agregue la siguiente configuración a la configuración de su cliente MCP:

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

Opción 3: Configuración de desarrollo local

1. Clone este repositorio:

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

2. Instale las dependencias:

   uv sync
   

3. Agregue la siguiente configuración a la configuración de su 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 último)

Indicadores de impulso

• 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 (impulso), CMO (oscilador de impulso de Chande), WILLR (porcentaje de Williams %R)

Indicadores de volatilidad

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

Indicadores de volumen

• Volumen: OBV (volumen en 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)