Ashare-MCP

Um serviço de dados do mercado de ações para consultar dados do mercado A-share da Sina e Tencent Finance.

Documentação

Ashare-MCP

Ashare-MCP é um serviço de dados de cotações de ações baseado em mpquant/Ashare, que fornece funcionalidades de consulta de dados de mercado do mercado A através do MCP (Model Context Protocol).

Recursos

Suporta dados de mercado em vários períodos: linha de minutos (1m, 5m, 15m, 30m, 60m), linha diária (1d), linha semanal (1w), linha mensal (1M)
Suporta vários formatos de código de ação: formato Tongdaxin (sh000001), formato JoinQuant (000001.XSHG)
Duas fontes de dados principais: Sina Finance e Tencent Finance, aumentando a estabilidade da obtenção de dados
Processamento assíncrono, melhorando o desempenho
Interface de API simples e fácil de usar

Instalação

# 通过 GitHub 安装
pip install git+https://github.com/RusianHu/Ashare-mcp.git

# 如果需要使用代理
pip install git+https://github.com/RusianHu/Ashare-mcp.git --proxy socks5://127.0.0.1:10808

# 通过本地安装（开发模式）
git clone https://github.com/RusianHu/Ashare-mcp.git
cd Ashare-mcp
pip install -e .

Como usar

Usar como serviço MCP

Adicione a configuração do serviço no arquivo de configuração do MCP:

{
  "mcpServers": {
    "ashare-mcp": {
      "command": "python",
      "args": [
        "-m",
        "ashare_mcp"
      ],
      "alwaysAllow": [
        "get_price"
      ],
      "disabled": false
    }
  }
}

Executar como serviço independente

# 使用标准输入输出模式
ashare-mcp

# 使用 HTTP 模式
fastmcp serve ashare_mcp

Funções de ferramentas do MCP

get_price - Obter dados de cotações de ações

Obtém dados de cotações de ações, suportando linha de minutos, diária, semanal e mensal.

Parâmetro	Descrição	Tipo	Valor padrão
`code`	Código de segurança, como 'sh000001' ou '000001.XSHG'	string	-
`end_date`	Data de término, formato 'YYYY-MM-DD'	string	data atual
`count`	Número de candles (K-lines) a obter	integer	10
`frequency`	Período do candle (K-line), valores possíveis: '1m', '5m', '15m', '30m', '60m', '1d', '1w', '1M'	string	'1d'
`fields`	Lista de campos de retorno	array	todos

Valor de retorno: Um objeto contendo o código da ação, dados de mercado e mensagem de processamento.

Exemplo

Exemplo de código

# 获取上证指数最近5天的日线数据
result = await get_price_ashare_mcp(code="sh000001", count=5, frequency="1d")

# 获取贵州茅台指定日期的历史数据
result = await get_price_ashare_mcp(code="sh600519", end_date="2023-01-01", count=10, frequency="1d")

# 获取分钟线数据
result = await get_price_ashare_mcp(code="sh600519", count=5, frequency="15m")

Dependências

fastmcp>=0.1.0
pandas
requests

Contribuição

Bem-vindo a enviar Issues e Pull Requests para ajudar a melhorar este projeto!

Licença

MIT