Kwipu MCP
MCP-сервер ищет ответы в личной базе документов и возвращает связанные фрагменты с указанием источников.
- 610 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Сервер читает выбранные документы и сохраняет граф; содержимое получает выбранная локальная или облачная модель.
Установка
- Работает в
Ручная установка
{
"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-сервер открывает агенту чтение и поиск по локальным базам Molio, включая дерево файлов и вопросы по содержимому.
MCP-сервер связывает агента с учебным холстом, где вопрос к фрагменту документа открывает новый связанный материал.
Локальная база документов для агента: гибридный поиск по смыслу и словам и веб-интерфейс для просмотра и загрузки
PageIndex MCP — длинные PDF для агента
PageIndex MCP
MCP-сервер дает агенту читать длинные PDF по дереву структуры документа: поиск рассуждением вместо векторной базы
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
Коротко о README
Kwipu сохраняет происхождение структурных связей вплоть до файла и строки. Обработку синонимов в MCP-режиме автор отключил.