Metadata-Version: 2.4
Name: ya-wiki-mcp
Version: 0.1.1
Summary: MCP server for Yandex Wiki API — pages, grids, YFM syntax, prompt templates
License-Expression: MIT
License-File: LICENSE
Keywords: fastmcp,mcp,wiki,yandex
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.11
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# ya-wiki-mcp

MCP-сервер для работы с API Яндекс Вики. Совместим с Claude Code, Claude Desktop и любым MCP-клиентом.

## Быстрый старт

```bash
# Добавить в Claude Code
claude mcp add ya-wiki -e YA_WIKI_TOKEN=ваш-токен -e YA_WIKI_ORG_ID=ваш-org-id -- uvx ya-wiki-mcp

# Или запустить вручную
uvx ya-wiki-mcp
```

## Возможности

- **27 инструментов** — полный CRUD для страниц, динамических таблиц (гридов) и ресурсов
- **Справочник YFM** — встроенная документация по разметке Yandex Flavored Markdown
- **Конвертер Markdown → YFM** — автоматически конвертирует стандартный Markdown в формат Вики
- **Шаблоны промптов** — управление переиспользуемыми шаблонами страниц прямо из чата

## Настройка

| Переменная | Обязательна | Описание |
|------------|-------------|----------|
| `YA_WIKI_TOKEN` | Да | OAuth-токен. Получить: https://oauth.yandex.ru/ |
| `YA_WIKI_ORG_ID` | Да | ID организации |
| `YA_WIKI_ORG_TYPE` | Нет | `cloud` (по умолчанию) или `business` |

Можно указать в `.env` файле или передать через флаги `-e`.

### Получение токена

1. Перейдите на https://oauth.yandex.ru/ и создайте приложение
2. Выберите "Для доступа к API или отладки"
3. Добавьте права: `wiki:write` (полный доступ) или `wiki:read` (только чтение)
4. Получите токен: `https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>`

## Инструменты

### Страницы
| Инструмент | Описание |
|------------|----------|
| `get_page` | Получить страницу по slug или ID |
| `get_page_content` | Получить только текст страницы (без метаданных) |
| `create_page` | Создать страницу (wysiwyg, page, grid, template) |
| `update_page` | Обновить заголовок, контент или редирект |
| `delete_page` | Удалить страницу (возвращает токен восстановления) |
| `clone_page` | Клонировать страницу в новое расположение |
| `append_content` | Добавить текст к странице (в начало, конец, секцию или якорь) |

### Ресурсы
| Инструмент | Описание |
|------------|----------|
| `get_page_resources` | Вложения, таблицы, SharePoint-документы страницы |
| `get_page_grids` | Список гридов, привязанных к странице |

### Динамические таблицы (гриды)
| Инструмент | Описание |
|------------|----------|
| `create_grid` | Создать таблицу на странице |
| `get_grid` | Получить таблицу с фильтрацией и сортировкой |
| `update_grid` | Обновить заголовок или сортировку |
| `delete_grid` | Удалить таблицу |
| `add_rows` | Добавить строки |
| `delete_rows` | Удалить строки |
| `add_columns` | Добавить колонки |
| `delete_columns` | Удалить колонки |
| `update_cells` | Обновить значения ячеек |
| `move_rows` | Переместить строки |
| `move_columns` | Переместить колонки |
| `clone_grid` | Клонировать таблицу на другую страницу |

### Утилиты
| Инструмент | Описание |
|------------|----------|
| `convert_md_to_yfm` | Конвертировать Markdown в YFM (таблицы, callouts, details, underline, highlight) |

### Менеджер промптов
| Инструмент | Описание |
|------------|----------|
| `prompts_list` | Список всех сохранённых шаблонов |
| `prompts_get` | Получить и отрендерить шаблон с аргументами |
| `prompts_add` | Создать шаблон из чата |
| `prompts_add_from_file` | Загрузить шаблон из файла |
| `prompts_remove` | Удалить шаблон |

## Конвертер Markdown → YFM

Яндекс Вики использует YFM (Yandex Flavored Markdown), который отличается от стандартного Markdown. Конвертер автоматически преобразует:

| Markdown | YFM |
|----------|-----|
| `\| H1 \| H2 \|` таблицы | `#\| \|\| \|#` wiki-таблицы |
| `> [!NOTE]` callouts | `{% note info %}` |
| `<details><summary>` | `{% cut "Title" %}` |
| `<u>text</u>` | `++text++` |
| `<mark>text</mark>` | `==text==` |
| `<sup>text</sup>` | `text^super^` |
| `<sub>text</sub>` | `text~sub~` |

## Лицензия

MIT
