Ashare-MCP

Un servicio de datos del mercado de valores para consultar datos del mercado de acciones A de Sina y Tencent Finance.

Documentación

Ashare-MCP

Ashare-MCP es un servicio de datos de cotizaciones bursátiles basado en mpquant/Ashare, que proporciona funciones de consulta de datos de mercado para el mercado de valores A a través de MCP (Model Context Protocol).

Características

Soporta datos de mercado en múltiples períodos: líneas de minutos (1m, 5m, 15m, 30m, 60m), líneas diarias (1d), líneas semanales (1w), líneas mensuales (1M)
Soporta múltiples formatos de códigos de acciones: formato Tongdaxin (sh000001), formato JoinQuant (000001.XSHG)
Fuentes de datos duales: Sina Finance y Tencent Finance, mejorando la estabilidad de la obtención de datos
Procesamiento asíncrono para mejorar el rendimiento
API simple y fácil de usar

Instalación

# 通过 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 .

Métodos de uso

Uso como servicio MCP

Agregue la configuración del servicio en el archivo de configuración de MCP:

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

Ejecución como servicio independiente

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

# 使用 HTTP 模式
fastmcp serve ashare_mcp

Funciones de herramientas MCP

get_price - Obtener datos de cotizaciones bursátiles

Obtiene datos de cotizaciones bursátiles, compatible con líneas de minutos, diarias, semanales y mensuales.

Parámetro	Descripción	Tipo	Valor predeterminado
`code`	Código de valor, como 'sh000001' o '000001.XSHG'	string	-
`end_date`	Fecha de finalización, formato 'YYYY-MM-DD'	string	Fecha actual
`count`	Número de velas a obtener	integer	10
`frequency`	Período de velas, valores opcionales: '1m', '5m', '15m', '30m', '60m', '1d', '1w', '1M'	string	'1d'
`fields`	Lista de campos a devolver	array	Todos

Valor de retorno: Objeto que contiene el código de la acción, los datos de mercado y el mensaje de procesamiento.

Ejemplos

Ejemplo 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")

Dependencias

fastmcp>=0.1.0
pandas
requests

Contribuciones

¡Bienvenidos Issues y Pull Requests para ayudar a mejorar este proyecto!

Licencia

MIT