evawiki-mcp 0.1.6

EvaWiki RAG MCP server

evawiki-mcp

MCP-сервер для работы с базой знаний EvaWiki. Предоставляет инструменты для поиска, просмотра, создания и редактирования документов, управления вложениями и семантического поиска по базе знаний.

Установка

pip install evawiki-mcp

или через uvx (без предварительной установки):

uvx evawiki-mcp@latest

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

Переменные окружения

Переменная	Обязательная	По умолчанию	Описание
EVAWIKI_ENDPOINT	Да	—	Базовый URL инстанса EvaWiki
EVAWIKI_TOKEN	Да	—	API-токен для аутентификации
EVAWIKI_RAG_URL	Нет	""	URL RAG API. При указании активирует инструмент evawiki_ask_query
EVAWIKI_CONTENT_FORMAT	Нет	yaml	Формат ответов: yaml или json

Запуск в режиме stdio

stdio — транспорт по умолчанию для MCP-клиентов (Claude Desktop, Cursor, VS Code и др.). Два варианта запуска:

Через CLI:

export EVAWIKI_ENDPOINT="https://evawiki.example.com"
export EVAWIKI_TOKEN="your-api-token"

evawiki-mcp

Через uvx (без установки):

EVAWIKI_ENDPOINT="https://evawiki.example.com" \
EVAWIKI_TOKEN="your-api-token" \
uvx evawiki-mcp@latest

Конфигурация для MCP-клиента

Добавьте в .mcp.json (или claude_desktop_config.json):

{
  "mcpServers": {
    "evawiki": {
      "command": "uvx",
      "args": ["evawiki-mcp@latest"],
      "env": {
        "EVAWIKI_ENDPOINT": "https://evawiki.example.com",
        "EVAWIKI_TOKEN": "your-api-token"
      }
    }
  }
}

Запуск в режиме HTTP

HTTP-режим подходит для развёртывания как сервис и подключения нескольких клиентов.

Через CLI:

export EVAWIKI_ENDPOINT="https://evawiki.example.com"
export EVAWIKI_TOKEN="your-api-token"

evawiki-mcp-http

Через uvicorn напрямую:

uvicorn rag_mcp.asgi_app:app --host 0.0.0.0

Сервер запустится на http://0.0.0.0:8000 (порт по умолчанию для uvicorn), MCP-эндпоинт — /mcp, health check — /health.

Конфигурация для MCP-клиента (HTTP)

{
  "mcpServers": {
    "evawiki": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp",
      "headers": {
        "evawiki-endpoint": "https://evawiki.example.com",
        "evawiki-token": "your-api-token"
      }
    }
  }
}

В HTTP-режиме credentials можно передавать через заголовки evawiki-endpoint и evawiki-token на каждый запрос — это позволяет обслуживать несколько EvaWiki-инстансов с одного сервера.

Инструменты (MCP Tools)

Вложения (Attachments)

Инструмент	Описание	Доступность
evawiki_attachment_list	Получает список вложений документа (только метаданные, без содержимого)	все режимы
evawiki_attachment_upload_from_url	Создаёт вложение в EvaWiki по HTTP(S)-ссылке	все режимы
evawiki_attachment_upload_from_file	Создаёт вложение в EvaWiki из локального файла	только stdio
evawiki_attachment_download	Скачивает вложение из EvaWiki на локальный диск	только stdio

Документы (Documents)

Инструмент	Описание	Доступность
evawiki_document_get	Получает метаданные документа по коду	все режимы
evawiki_document_text_get	Получает текстовое содержимое документа (опубликованная версия или черновик)	все режимы
evawiki_document_search	Ищет документы по подстроке в названии	все режимы
evawiki_document_draft_create	Создаёт новый документ в статусе черновика	все режимы
evawiki_document_draft_update	Обновляет документ и сохраняет как черновик	все режимы
evawiki_document_publish	Публикует черновик документа	все режимы

Проекты (Projects)

Инструмент	Описание	Доступность
evawiki_project_list	Получает список всех доступных проектов	все режимы
evawiki_project_documents_tree	Получает иерархию разделов и документов проекта	все режимы

Навигация и поиск

Инструмент	Описание	Доступность
evawiki_overview_get	Получает двухуровневый обзор базы знаний (проекты -> документы верхнего уровня)	все режимы
evawiki_ask_query	Семантический поиск по базе знаний с генерацией ответа (требует EVAWIKI_RAG_URL)	все режимы*

* Инструмент evawiki_ask_query регистрируется только при заданной переменной EVAWIKI_RAG_URL.

Различия между stdio и HTTP

Возможность	stdio	HTTP
Все инструменты для чтения	+	+
Создание и редактирование документов	+	+
Загрузка вложений из локального файла	+	—
Скачивание вложений на локальный диск	+	—
Аутентификация через заголовки запроса	—	+
Многопользовательский доступ	—	+
Запуск через uvx	+	—

Инструменты evawiki_attachment_upload_from_file и evawiki_attachment_download работают с локальной файловой системой, поэтому доступны только в stdio-режиме.

Стек технологий

• FastMCP — фреймворк для MCP-серверов
• evawiki-python-client — клиент API EvaWiki
• Pydantic — валидация данных и модели ответов
• httpx — HTTP-клиент
• uvicorn — ASGI-сервер

Лицензия

MIT