yandex-wiki-mcp

MCP server для работы с Яндекс Wiki через Claude Code и другие MCP-клиенты.

Инструменты

Установка через uvx

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["--python", "3.12", "yandex-wiki-mcp-server@latest"],
      "env": {
        "WIKI_IAM_TOKEN": "your-iam-token",
        "WIKI_CLOUD_ORG_ID": "your-cloud-org-id"
      }
    }
  }
}

Если у вас уже настроен Яндекс Трекер MCP — можно переиспользовать те же переменные:

{
  "mcpServers": {
    "yandex-wiki": {
      "command": "uvx",
      "args": ["--python", "3.12", "yandex-wiki-mcp-server@latest"],
      "env": {
        "TRACKER_IAM_TOKEN": "your-iam-token",
        "TRACKER_CLOUD_ORG_ID": "your-cloud-org-id"
      }
    }
  }
}

Сервер принимает оба набора переменных (WIKI_* приоритетнее, TRACKER_* как запасной вариант).

Аутентификация

Используется IAM-токен Яндекс Cloud. Получить токен:

yc iam create-token

IAM-токен действует до 12 часов. Для автообновления используйте yt-refresh скилл в Claude Code.

Обязательные переменные окружения:

Добавление в Claude Code

claude mcp add yandex-wiki --scope user \
  -- uvx --python 3.12 yandex-wiki-mcp-server@latest

Затем добавьте env-переменные в ~/.claude.json в секцию mcpServers.yandex-wiki.env.

Локальная разработка

git clone https://github.com/MoshkaBortmanStar/yandex-wiki-mcp.git
cd yandex-wiki-mcp
uv venv && uv pip install -e .

export TRACKER_IAM_TOKEN=$(yc iam create-token)
export TRACKER_CLOUD_ORG_ID=your-org-id

python -m yandex_wiki_mcp

Требования

• Python >= 3.10
• mcp >= 1.0.0
• httpx >= 0.27.0