Kwipu MCP

MCP-сервер ищет ответы в личной базе документов и возвращает связанные фрагменты с указанием источников.

  • 610 ★ репозитория
  • Последний коммит
  • MIT
MCP-серверОфициальный

Расширенный доступ

Почему такой уровень

  • Сервер читает выбранные документы и сохраняет граф; содержимое получает выбранная локальная или облачная модель.
Все причины и проверки

benmaster82/kwipu

Установка

Ручная установка

{
  "mcpServers": {
    "kwipu": {
      "command": "C:/path/to/Kwipu/.venv/Scripts/python.exe",
      "args": ["C:/path/to/Kwipu/kwipu_mcp_server.py"],
      "env": {
        "KWIPU_KNOWLEDGE_DIR": "C:/path/to/vault",
        "KWIPU_LLM_MODEL": "qwen2.5:7b",
        "KWIPU_EMBED_MODEL": "nomic-embed-text"
      }
    }
  }
}

Конфигурация из раздела MCP server. Сначала установите зависимости Kwipu и модели, затем замените примерные абсолютные пути.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • Сервер читает выбранные документы и сохраняет граф; содержимое получает выбранная локальная или облачная модель.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Kwipu MCP дает агенту поиск по графу документов. Kwipu связывает заметки по вики-ссылкам, метаданным и смыслу текста, а при ответе на вопрос подбирает относящиеся к нему фрагменты. Агент может получить короткий ответ или ответ вместе с источниками. В базу входят Markdown, текстовые файлы, PDF и DOCX. Тот же граф пользователь может исследовать через терминал или отдельный веб-интерфейс. Ответы учитывают временные сведения, поэтому пользователь может исследовать изменения решений между встречами.

Для кого. Руководителям проектов и авторам документации, которые ищут решения, роли и связи в папке заметок или хранилище Obsidian.

Подходит, если

  • После нескольких встреч вы хотите найти, кто принял решение и в каких заметках оно отражено.
  • В хранилище Obsidian накопились связи между людьми и проектами, которые нужно изучить.
  • Для ответа агента вам нужны исходные фрагменты, которые можно открыть и проверить.
  • В старых заметках вы ищете изменения решения по датам встреч.

Не подходит, если

  • Вы хотите поручить агенту редактировать исходные документы через этот сервер.
  • Исходные документы нельзя передавать выбранной облачной модели.
  • Для задачи нужен поиск по данным, которых нет в поддерживаемых файлах.

Пример запроса к агенту

Найди в Kwipu решения о сроках Project Alpha и покажи заметки, на которых основан ответ.

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

Для запуска нужны Python 3.12 и Ollama с подготовленными моделями; проверьте их доступность до подключения агента. Модель по умолчанию может работать в облаке: локальный адрес Ollama сам по себе не оставляет документы на компьютере. MCP создает недостающий индекс, но не следит за правками файлов, поэтому для обновления держите запущенным индексатор. При смене модели эмбеддингов нужно заново построить индекс; старые векторы нельзя использовать как результат новой модели.

Как отключить. Удалите Kwipu из MCP-клиента и остановите индексатор. Сохраненный граф удаляйте только после остановки всех процессов, которые его используют.

Частые вопросы

Как увидеть основания ответа?

Попросите агента вернуть ответ с источниками. Для этого у сервера есть отдельный инструмент подробного запроса.

Почему новые заметки не находятся?

Проверьте папку документов и работающий индексатор. Сам MCP-сервер не наблюдает за изменениями файлов.

Можно ли работать без браузера?

Да. Для MCP и терминального режима веб-интерфейс не требуется.

Что указать вместо путей из примера?

Абсолютные пути к Python в вашем окружении, файлу сервера и папке документов. Образец с диском C нужно адаптировать к своей установке.

Что будет с одинаковыми названиями заметок?

Для файлов из разных папок Kwipu использует имена с путем. Это помогает отличить действующую заметку от одноименной архивной.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

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

MCP-серверРасширенный доступ3,9 тыс.Звезды репозитория
Официальный

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

MCP-серверРасширенный доступ443Звезды репозитория
Официальный

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

MCP-серверРасширенный доступ327Звезды репозитория

Локальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки

MCP-серверРасширенный доступ344Звезды репозитория
Официальный

MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы

MCP-серверРасширенный доступ407Звезды репозитория

MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы

MCP-серверРасширенный доступ166Звезды репозитория

Коротко о README

Kwipu сохраняет происхождение структурных связей вплоть до файла и строки. Обработку синонимов в MCP-режиме автор отключил.

Бейдж для README

Сообщить о проблеме

Foxx AIKwipu MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.