ickyMCP

MCP-сервер RAG для семантического поиска по документам. Он индексирует локальные коллекции документов в SQLite с помощью sqlite-vec, а затем предоставляет инструменты MCP для индексации, поиска, обновления, перечисления и удаления проиндексированных документов.

Функции

• Семантический поиск по файлам PDF, Word, PowerPoint, Excel, Markdown и текстовым файлам

• Изоляция баз данных для каждого пользователя с опциональным устаревшим режимом единой базы данных

• Фильтры по ID документа для поиска в рамках чата или конкретного дела

• Инкрементальная индексация на основе размера файла и времени изменения

• Эмбеддинги Voyage AI по умолчанию, с автономным локальным бэкендом sentence-transformers

• Портативное хранилище SQLite с игнорированием локальных артефактов базы данных

Related MCP server: MCP-RAGNAR

Настройка

python -m venv .venv
.\.venv\Scripts\activate
pip install -r requirements.txt

Создайте настройки локальной среды из примера:

copy .env.example .env

Установите ICKY_VOYAGE_API_KEY при использовании бэкенда Voyage по умолчанию. Для автономного использования установите ICKY_EMBEDDING_PROVIDER=local.

Конфигурация

Конфигурация Claude MCP

{
  "mcpServers": {
    "ickyMCP": {
      "command": "python",
      "args": ["C:\\Users\\devan\\OneDrive\\Desktop\\Projects\\ickyMCP\\run.py"],
      "env": {
        "ICKY_EMBEDDING_PROVIDER": "voyage",
        "ICKY_VOYAGE_API_KEY": "YOUR_VOYAGE_API_KEY",
        "ICKY_CHUNK_SIZE": "5000",
        "ICKY_CHUNK_OVERLAP": "500"
      }
    }
  }
}

Инструменты

• index: индексация файла или директории; принимает user_id, patterns, exclude и force

• search: семантический запрос по проиндексированным чанкам; принимает document_ids, path_filter и file_types

• similar: поиск чанков, похожих на предоставленный текст

• refresh: повторная индексация измененных файлов и удаление удаленных файлов из индекса

• list: перечисление проиндексированных документов и их ID

• delete: удаление по пути, ID документов или всех документов

• status: возврат статуса базы данных, эмбеддингов и разбиения на чанки

Проверка

python -m compileall -q src run.py fast_index.py
python -c "from src.config import EMBEDDING_PROVIDER; print(EMBEDDING_PROVIDER)"

Корневые файлы test_*.py — это интеграционные скрипты, которые ожидают локальные документы в папке docs/ и, для бэкенда по умолчанию, настроенный API-ключ Voyage.

Гигиена данных

Сгенерированные базы данных и локальные папки с документами игнорируются git: *.db, *.db.bak, *.sqlite, *.sqlite3, data/ и docs/. Храните реальные API-ключи в переменных окружения или .env, а не в отслеживаемых файлах.

Лицензия

MIT