A-Share MCP — MCP-сервер для данных A-акций

A-Share MCP — MCP-сервер (Model Context Protocol), ориентированный на рынок A-акций Китая. Предоставляет единый интерфейс для получения фундаментальных данных, исторических котировок, финансовой отчётности, макроэкономических показателей, состава индексов и многого другого. Сервер можно подключить к MCP-совместимым клиентам (Cursor, VS Code, CherryStudio) и задавать вопросы об A-рынке на естественном языке — он ответит данными в реальном времени.

Под капотом используется открытый источник Baostock, не требующий регистрации и оплаты. Проект разработан под Windows, но работает и на macOS/Linux.

Функциональность

Сервер реализует следующие группы инструментов (всего более 20 функций):

• Акции: информация об акции, исторические K-линии (дневные/недельные/минутные), дивиденды, коэффициенты коррекции.
• Финансовая отчётность: данные о прибыли, операциях, росте, балансе, движении денег, коэффициент Дюпона.
• Индексы: состав и данные индексов (上证50, 沪深300, 中证500), отраслевая принадлежность.
• Макроэкономика: ставки по депозитам и кредитам, нормы резервирования, денежная масса (M2 и др.), SHIBOR.
• Даты и анализ: получение последнего торгового дня, расчёт аналитических показателей.

Установка и запуск

Предварительные требования

• Python 3.10+
• uv — менеджер зависимостей (рекомендуется)

Инструкция

1. Клонируйте репозиторий, перейдите в корневую папку a_share_mcp.
2. Выполните команды в терминале:

uv venv               # создать виртуальное окружение
# активировать:
# Windows:
.venv\Scripts\activate
# macOS/Linux:
source .venv/bin/activate

uv sync               # установить зависимости

Сервер запускается из активированного окружения:

python mcp_server.py

Настройка в MCP-клиенте

Вариант 1: JSON-конфигурация (VS Code, Cursor, Trae)

В конфигурацию MCP-клиента (обычно поле mcpServers в JSON-файле) добавьте:

{
  "mcpServers": {
    "a-share-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/полный/путь/до/a_share_mcp",
        "run",
        "python",
        "mcp_server.py"
      ],
      "transport": "stdio"
    }
  }
}

• Замените путь на актуальный абсолютный путь к проекту.
• В Windows используйте двойные обратные слеши (\\), в macOS/Linux — обычные (/).
• Если uv не найден по короткому имени, укажите полный путь к uv.exe.
• Если возникает ошибка ModuleNotFoundError, попробуйте добавить "workingDirectory": "C:/путь/до/a_share_mcp".

Вариант 2: CherryStudio

В интерфейсе MCP CherryStudio заполните поля:

• Название: a-share-mcp
• Тип: stdio
• Команда: uv
• Параметры (каждый с новой строки):

--directory
C:\полный\путь\до\a_share_mcp
run
python
mcp_server.py

Важно: После сохранения параметров иногда индикатор не загорается зелёным. Переключитесь на любую другую страницу настроек и вернитесь — статус обновится.

Особенности данных

Baostock обновляет информацию не мгновенно:

• Дневные K-линии текущего торгового дня — после 17:30.
• Факторы коррекции — после 18:00.
• Минутные K-линии — на следующий день к 11:00.
• Финансовая отчётность — на следующий день к 1:30.
• Недельные данные — по субботам 17:30.
• Составы индексов — каждый понедельник после обеда.

Запросы до указанного времени вернут данные предыдущего дня.

Сообщество и поддержка

Проект распространяется по лицензии MIT. Вы можете сообщать об ошибках, предлагать улучшения через Issues и Pull Requests на GitHub.

Если проект помог, авторы будут рады чашечке кофе ❤️

Документация Baostock: ссылка