@mmtr-tech/yandex-wiki-mcp

MCP-сервер для публичного API Яндекс Вики (OAuth + Яндекс 360 / X-Org-Id).

English version

Установка / запуск в Cursor

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "npx",
      "args": ["-y", "@mmtr-tech/yandex-wiki-mcp"],
      "env": {
        "WIKI_TOKEN": "your-oauth-token",
        "WIKI_ORG_ID": "your-org-id"
      }
    }
  }
}

Опционально: "WIKI_BASE_URL": "https://api.wiki.yandex.net/v1", "WIKI_READ_ONLY": "true" (блокирует write tools).

После изменения конфига — Restart Cursor. Не держите второй похожий Wiki MCP параллельно.

Локальная разработка (без npm)

cp .env.example .env
npm install
npm run test:unit
npm run typecheck
npm run dev

Или в mcp.json: npx tsx /ABS/PATH/TO/yandex-wiki/src/index.ts с теми же env.

Env

| Переменная | Обязательно | Описание | |------------|-------------|----------| | WIKI_TOKEN | да | OAuth-токен (Authorization: OAuth …) | | WIKI_ORG_ID | да | Id организации Яндекс 360 (X-Org-Id) | | WIKI_BASE_URL | нет | По умолчанию https://api.wiki.yandex.net/v1 | | WIKI_READ_ONLY | нет | true / 1 — блокирует create/update/append/add_comment/upload |

Как получить OAuth-токен и org id

См. доступ к API.

1. Приложение на oauth.yandex.ru → Для доступа к API или отладки.
2. Права: wiki:read (чтение) и wiki:write (create/update/append/comments/upload).
3. Токен: https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>.
4. Org id: Трекер → Администрирование → Организации → скопировать id.

Проверка:

curl -s 'https://api.wiki.yandex.net/v1/users/me' \
  -H "Authorization: OAuth $WIKI_TOKEN" \
  -H "X-Org-Id: $WIKI_ORG_ID"

Tools (17)

Read: wiki_me, wiki_get_page (slug или URL; валидные fields), wiki_get_page_by_id, descendants, wiki_search, comments (+ include_threads), resources/attachments/grids.

Write: wiki_create_page, wiki_update_page, wiki_append_content, wiki_add_comment, wiki_upload_attachment (абсолютный filePath на хосте MCP; опционально embed вставляет картинку/файл на страницу). Редактирования комментария в Public API нет.

Типичный поток: URL/slug → wiki_get_page → wiki_list_comments → wiki_add_comment. Файлы: wiki_upload_attachment.

Публикация (maintainers)

npm run prepublishOnly
npm publish --access public

Нужен доступ к scope @mmtr-tech на npm.

License

MIT