AKShare One

Servidor MCP AKShare One

Visão Geral

Um servidor MCP baseado em akshare-one, que fornece interfaces abrangentes para dados do mercado de ações da China. Ele oferece um conjunto de ferramentas poderosas para recuperar informações financeiras, incluindo dados históricos de ações, dados em tempo real, dados de notícias e demonstrações financeiras.

Ferramentas Disponíveis

Fallback automático de fonte

Exceto para get_news_data e get_inner_trade_data, cujo upstream expõe uma única fonte, toda ferramenta aceita um parâmetro source para a fonte de dados preferida e um parâmetro fallback (ativado por padrão) que decide se as outras fontes do mesmo domínio são tentadas quando essa fonte gera erro ou retorna um quadro vazio:

Domínio	Ordem tentada
Histórico	eastmoney → eastmoney_direct → sina
Tempo real	eastmoney_direct → eastmoney → xueqiu (ignorada quando nenhum símbolo é fornecido)
Demonstrações financeiras	sina ⇄ eastmoney_direct

O source solicitado é sempre tentado primeiro; a ordem apenas governa o fallback. Como o akshare-one projeta cada fonte nas colunas declaradas do seu domínio, o fallback não pode alterar os nomes dos campos ou sua ordem. Quando todas as fontes falham, o erro lista cada uma e o motivo da falha; quando todas as fontes são bem-sucedidas, mas não há dados, um resultado vazio é retornado. Defina fallback como false para fixar uma única fonte — uma falha então aparece diretamente, o que é útil quando você precisa saber exatamente de onde vieram os números.

A fonte que realmente atendeu a uma chamada é registrada no logger akshare_one_mcp.providers.

Ferramentas de Dados de Mercado

get_hist_data

Obtenha dados históricos do mercado de ações com suporte a múltiplos períodos de tempo e métodos de ajuste.

Parâmetros

• symbol (string, obrigatório): Código da ação (ex.: '000001')
• interval (string, opcional): Intervalo de tempo ('minute','hour','day','week','month','year') (padrão: 'day')
• interval_multiplier (número, opcional): Multiplicador de intervalo (padrão: 1)
• start_date (string, opcional): Data de início no formato AAAA-MM-DD (padrão: '1970-01-01')
• end_date (string, opcional): Data de término no formato AAAA-MM-DD (padrão: '2030-12-31')
• adjust (string, opcional): Tipo de ajuste ('none', 'qfq', 'hfq') (padrão: 'none')
• source (string, opcional): Fonte de dados ('eastmoney', 'eastmoney_direct', 'sina') (padrão: 'eastmoney')
• fallback (booleano, opcional): Tenta 'eastmoney', 'eastmoney_direct' e 'sina' em ordem quando a fonte escolhida falha ou não tem dados (padrão: true)
• indicators_list (lista, opcional): Indicadores técnicos a adicionar
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 100)

get_realtime_data

Obtenha dados do mercado de ações em tempo real.

Parâmetros

• symbol (string, opcional): Código da ação
• source (string, opcional): Fonte de dados ('eastmoney_direct', 'eastmoney', 'xueqiu') (padrão: 'eastmoney_direct')
• fallback (booleano, opcional): Tenta 'eastmoney_direct', 'eastmoney' e 'xueqiu' em ordem quando a fonte escolhida falha ou não tem dados (padrão: true; 'xueqiu' é ignorada quando nenhum símbolo é fornecido, pois ela cotiza um símbolo por vez)

Ferramentas de Notícias e Informações

get_news_data

Obtenha dados de notícias relacionadas a ações.

Parâmetros

• symbol (string, obrigatório): Código da ação
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 10)

Ferramentas de Demonstrações Financeiras

get_balance_sheet

Obtenha dados do balanço patrimonial da empresa.

Parâmetros

• symbol (string, obrigatório): Código da ação
• source (string, opcional): Fonte de dados ('sina', 'eastmoney_direct') (padrão: 'sina')
• fallback (booleano, opcional): Tenta a outra fonte quando a escolhida falha ou não tem dados (padrão: true)
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 10)

get_income_statement

Obtenha dados da demonstração de resultados da empresa.

Parâmetros

• symbol (string, obrigatório): Código da ação
• source (string, opcional): Fonte de dados ('sina', 'eastmoney_direct') (padrão: 'sina')
• fallback (booleano, opcional): Tenta a outra fonte quando a escolhida falha ou não tem dados (padrão: true)
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 10)

get_cash_flow

Obtenha dados da demonstração do fluxo de caixa da empresa.

Parâmetros

• symbol (string, obrigatório): Código da ação
• source (string, opcional): Fonte de dados ('sina', 'eastmoney_direct') (padrão: 'sina')
• fallback (booleano, opcional): Tenta a outra fonte quando a escolhida falha ou não tem dados (padrão: true)
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 10)

Ferramentas de Análise e Métricas

get_inner_trade_data

Obtenha dados de negociação de insider da empresa.

Parâmetros

• symbol (string, obrigatório): Código da ação

get_financial_metrics

Obtenha métricas financeiras-chave das três principais demonstrações financeiras.

Parâmetros

• symbol (string, obrigatório): Código da ação
• source (string, opcional): Fonte de dados ('sina', 'eastmoney_direct') (padrão: 'eastmoney_direct')
• fallback (booleano, opcional): Tenta a outra fonte quando a escolhida falha ou não tem dados (padrão: true)
• recent_n (número, opcional): Número de registros mais recentes a retornar (padrão: 10)

get_time_info

Obtenha a hora atual com formato ISO, timestamp e o último dia de negociação.

Instalação e Configuração

Modos de Execução

O servidor suporta dois modos: stdio e streamable-http

Argumentos de Linha de Comando:

• --streamable-http: Ativa o modo HTTP (padrão: modo stdio)
• --host: Host para vincular no modo HTTP (padrão: 0.0.0.0)
• --port: Porta para escutar no modo HTTP (padrão: 8081)

Nota: Ao usar o modo streamable-http, o servidor MCP estará disponível em http://{host}:{port}/mcp. Para a configuração padrão, isso seria http://0.0.0.0:8081/mcp.

Opções de Instalação

Opção 1: Via Smithery

Para instalar akshare-one-mcp para Claude Desktop automaticamente via Smithery:

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

Opção 2: Via uv

Instale uv se você ainda não o tiver.

uvx instala o pacote do PyPI e o executa no Python 3.12 ou mais recente.

Adicione a seguinte configuração às configurações do seu Cliente MCP:

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

Opção 3: Configuração de Desenvolvimento Local

1. Clone este repositório:

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

2. Instale as dependências:

   uv sync
   

3. Adicione a seguinte configuração às configurações do seu Cliente MCP:

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

Referência de Indicadores Técnicos

A ferramenta get_hist_data suporta os seguintes indicadores técnicos:

Indicadores de Tendência

• Médias Móveis: SMA (Média Móvel Simples), EMA (Média Móvel Exponencial)
• Rastreamento de Tendência: MACD (Convergência/Divergência de Média Móvel), APO (Oscilador de Preço Absoluto), PPO (Oscilador de Preço Percentual)
• Taxa de Variação: ROC (Taxa de Variação), ROCP (Taxa de Variação Percentual), ROCR (Razão de Taxa de Variação), ROCR100
• Outros: TRIX (Média Móvel Exponencial Tripla), ULTOSC (Oscilador Definitivo)

Indicadores de Momentum

• Força Relativa: RSI (Índice de Força Relativa), CCI (Índice de Canal de Commodities)
• Força de Tendência: ADX (Índice Direcional Médio), DX (Índice Direcional)
• Fluxo de Dinheiro: MFI (Índice de Fluxo de Dinheiro), MOM (Momentum), CMO (Oscilador de Momentum de Chande), WILLR (Williams %R)

Indicadores de Volatilidade

• Bandas de Bollinger: BOLL (Bandas de Bollinger)
• Intervalo Verdadeiro Médio: ATR (Intervalo Verdadeiro Médio)
• SAR Parabólico: SAR (Stop and Reverse Parabólico)

Indicadores de Volume

• Volume: OBV (Volume de Saldo), AD (Linha de Acumulação/Distribuição), ADOSC (Oscilador de Acumulação/Distribuição)

Outros Indicadores

• Estocástico: STOCH (Oscilador Estocástico)
• Aroon: AROON (Indicador Aroon), AROONOSC (Oscilador Aroon)
• Equilíbrio de Poder: BOP (Equilíbrio de Poder)
• Indicadores Direcionais: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
• Previsão de Série Temporal: TSF (Previsão de Série Temporal)