# AKTools

AKTools — MCP-сервер с тремя инструментами AKShare: ассистент находит нужный интерфейс, читает его параметры и получает котировки, данные о фондах или макроданные.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1578 у репозитория
- Автор: akfamily
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/akfamily/aktools
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/aktools

## Что делает

AKTools превращает вызовы AKShare в три MCP-инструмента: `search_interfaces` ищет функцию по ключевому слову, `describe_interface` показывает её параметры, `get_data` забирает сами данные. Ассистенту не надо помнить имена функций — он находит их сам и подставляет аргументы.

Тот же каталог интерфейсов открыт и по HTTP. `pip install aktools` и `python -m aktools` поднимают сервис на `http://127.0.0.1:8080`, где эндпоинт повторяет имя функции AKShare: `http://127.0.0.1:8080/api/public/stock_zh_a_hist?symbol=600000`. Кэш держит ответ 60 секунд, поэтому повторные запросы не бьют по источнику лишний раз.

Для MCP-режима ставить пакет заранее не нужно: помощник запускает сервер через `uvx`. Сам `uv` должен быть в системе, иначе команда не отработает. Первый запуск тянет зависимости, около 150 MB, и занимает несколько минут. Для HTTP-варианта нужен 64-битный Python 3.11 и новее.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add aktools -- uvx aktools
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from aktools <команда>

### Codex

**Командой платформы**
```bash
codex mcp add aktools -- uvx aktools
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from aktools <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aktools": {
            "command": "uvx",
            "args": [
                "aktools"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from aktools <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "aktools": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "aktools"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from aktools <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add aktools uvx aktools
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from aktools <команда>

## Когда брать
- Вытащить дневные котировки бумаги за нужный период, не разбираясь в именах функций AKShare
- Найти подходящий интерфейс по ключевому слову
- Посмотреть аргументы функции и их значения по умолчанию перед вызовом
- Сохранить ответ в CSV или Excel через `_format`
- Отдать те же данные скрипту на другом языке по HTTP

## Примеры запросов агенту
- Найди через AKTools интерфейс для дневных котировок акций и покажи его параметры.
- Забери дневную историю по `600000` и сохрани в CSV.
- Какие интерфейсы AKShare связаны с конвертируемыми облигациями?

## Похожие
- [alphaear-stock](https://affpapa.org/nevibecode/skills/alphaear-stock.md) — скилл · 1300 установок
- [TokenBel Financial Data](https://affpapa.org/nevibecode/mcp/tokenbel-financial-data.md) — MCP-сервер · 2830 установок
- [Blocksize Market Data](https://affpapa.org/nevibecode/mcp/blocksize-market-data.md) — MCP-сервер · 885 установок
- [Financial Modeling Prep](https://affpapa.org/nevibecode/mcp/financial-modeling-prep.md) — MCP-сервер · 873 установки
- [IPOGrid Research](https://affpapa.org/nevibecode/mcp/ipogrid-research.md) — MCP-сервер · 653 установки
- [helium-mcp](https://affpapa.org/nevibecode/mcp/helium-mcp.md) — MCP-сервер · 204 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
