AKTools MCP
MCP-сервер и HTTP API на AKShare: агент находит интерфейс финансовых данных по рынкам Китая, смотрит параметры и получает таблицы
- 1 556 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Ходит в сеть к публичным сайтам финансовых данных и сам скачивает зависимости при первом запуске
- HTTP-режим слушает порт на машине, при доступе из локальной сети данные открыты всем в ней
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/aktoolsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Ходит в сеть к публичным сайтам финансовых данных и сам скачивает зависимости при первом запуске
- HTTP-режим слушает порт на машине, при доступе из локальной сети данные открыты всем в ней
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AKTools оборачивает библиотеку AKShare, открытый сборник интерфейсов к финансовым данным, в два сервиса. HTTP API запускает команда `python -m aktools`, и любой язык или программа получает данные по адресу вида `/api/public/<имя интерфейса>`. MCP-сервер `aktools-mcp` подключается к агенту и работает без отдельно запущенного сервиса. Агент получает три инструмента. `search_interfaces` ищет интерфейс по ключевым словам, `describe_interface` показывает его параметры и значения по умолчанию, `get_data` возвращает данные. По запросу вроде «дневные котировки Гуйчжоу Маотай за октябрь 2024 с обратным восстановлением цен» агент сам находит нужный интерфейс и подставляет параметры. Те же данные выгружаются в JSON, CSV или XLSX. Повторный запрос с теми же параметрами в течение 60 секунд возвращается из кэша, чтобы реже обращаться к сайтам-источникам.
Для кого. Для аналитиков и разработчиков, которые спрашивают Claude Code, Cursor или Claude Desktop о китайских рынках и хотят получать таблицы данных AKShare без собственного кода.
Подходит, если
- Нужны исторические котировки акций А-рынка Китая, и агент должен сам найти интерфейс и параметры
- Нужно узнать, какие интерфейсы AKShare есть по теме, например по конвертируемым облигациям
- Данные нужны в Excel или CSV: к запросу добавляют `_format=xlsx` или `_format=csv`
- Одним сервисом на сервере должны пользоваться несколько компьютеров или скрипты на разных языках
Не подходит, если
- Нужны котировки в реальном времени для торговли: сервис пересылает запросы к открытым сайтам-источникам, задержки и сбои возможны
- Вы ищете инвестиционную рекомендацию: разработчик пишет, что данные предназначены для научных исследований
- Сервер стоит там, где недоступны сайты вроде Eastmoney и Sina: часть интерфейсов отдает ошибку 502
Пример запроса к агенту
Найди в AKShare интерфейс дневных котировок А-акций, проверь его параметры и выгрузи данные по коду 600519 за октябрь 2024 с обратным восстановлением ценMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
- Работает на Python 3.11 и новее. При первом запуске через `uvx` скачиваются зависимости, включая AKShare, около 150 МБ.
- Данные приходят из публичных сайтов-источников, поэтому интерфейсы ломаются, когда сайт меняет разметку. Разработчик советует обновить `akshare` и `aktools` до последних версий.
- Часть интерфейсов работает только из сети внутри Китая, подробности в документации AKShare.
- За ошибки в самих данных отвечает AKShare: AKTools только пересылает запросы и отдает ответ как есть.
Как отключить. Удалите запись aktools из MCP-конфигурации агента, для Claude Code командой `claude mcp remove aktools`. HTTP-сервис остановите сочетанием Ctrl+C в терминале, где он запущен, пакет удаляет `pip uninstall aktools`.
Частые вопросы
Как поставить AKTools в Claude Code?
Выполните `claude mcp add aktools -- uvx --from aktools aktools-mcp`. Предварительно нужен uv. Устанавливать пакет заранее и запускать сервис вручную не требуется.
Можно ли развернуть AKTools на сервере для команды?
Да, HTTP API разворачивается в Docker с Gunicorn. Тогда одним сервисом пользуются несколько компьютеров и скрипты на разных языках.
Чем MCP-режим AKTools отличается от HTTP API?
MCP подключается к агенту и стартует сам через `uvx`. HTTP API запускается командой `python -m aktools` и подходит для скриптов и приложений на любом языке. Каталог интерфейсов, кэш и обработка ошибок у них общие.
Можно ли подключить агент к уже запущенному AKTools?
Да, у запущенного сервиса есть адрес `http://127.0.0.1:8080/mcp`. Например, для Claude Code: `claude mcp add --transport http aktools http://127.0.0.1:8080/mcp`.
Почему данные не обновляются сразу?
Ответы кэшируются на 60 секунд. Заголовок `X-AKTools-Cache: hit` показывает, что ответ пришел из кэша. Запуск с параметром `--cache-ttl 0` отключает кэш.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер на akshare с котировками, показателями и новостями по акциям Китая, Гонконга и США и данными по криптовалютам
Облачный MCP-сервер финансовых данных: котировки, отчетность, макростатистика и фирменные факторы FTShare только на чтение
Сервер отдает агенту котировки А-акций, Гонконга и США, индикаторы, фонды, фьючерсы и опционы, а еще четыре готовых скилла.
Локальная база котировок и ETF китайского фондового рынка A-share с MCP-сервером для запросов на естественном языке
MCP-сервер и CLI с котировками акций Китая, Гонконга и США: 92 инструмента для K-линий, индикаторов и фондов без ключей
MCP дает агенту читать локальный архив китайского рынка и проверять охват, происхождение и даты финансовых данных
Коротко о README
README объясняет два способа работы: HTTP API и MCP-сервер. Дальше идут установка, таблица адресов для проверки, параметры запуска, примеры вызова из разных языков и развертывание через Docker с Gunicorn. Завершают его ответы на частые ошибки 502 и 404 и отказ от ответственности за данные.