MSIM – MCP Server Integration Manager

MSIM — это унифицированный MCP-сервер (Model Context Protocol), который связывает AnythingLLM с любым MCP‑совместимым клиентом (Better DeepSeek, Claude Desktop, Cursor, VS Code, пользовательские агенты).

Он предоставляет единую конечную точку для транспортов HTTP/JSON‑RPC, SSE и WebSocket, а также автоматически управляет выбором рабочей области, логированием и фоновой работой.

Возможности

• Полная поддержка MCP – initialize, tools/list, tools/call, notifications/initialized, ping, prompts/list, resources/list.

• Мультитранспорт – HTTP (/mcp), SSE (/sse), WebSocket (/ws).

• Автоматическое определение рабочей области – использует первую рабочую область, если не указана иная.

• Интерактивная настройка – при первом запуске запрашивает API-ключ AnythingLLM, базовый URL и рабочую область.

• Структурированное логирование и ротация – журналы в формате JSON или обычном тексте с автоматической ротацией.

• Корректное завершение работы – ожидает завершения выполняющихся вызовов инструментов.

• Режим супервизора – автоматический перезапуск при сбое (с ограничением).

• Баннер конечных точек – показывает все доступные URL при запуске.

• Поддержка Docker – запускается с помощью docker-compose up вместе с AnythingLLM.

• Кроссплатформенность – работает на Windows, macOS, Linux.

Related MCP server: anythingllm-mcp

Установка

Предварительные требования

• Git (для клонирования репозитория)

• AnythingLLM – запущенный локально (Desktop или Docker) с Developer API Key (создайте в разделе Settings → API Keys).

Быстрая установка (вручную)

git clone https://github.com/giancbaring/msim
cd msim
git submodule update --init --recursive
./install.sh   # or install.ps1 on Windows

Установщик выполнит следующее:

1. Установит uv (если отсутствует).

2. Установит Python 3.12 с помощью uv (если отсутствует).

3. Удалит старое виртуальное окружение.

4. Установит все зависимости Python (включая обёртку).

5. Проверит код.

6. Запустит интерактивную настройку (запросит API-ключ, базовый URL и рабочую область).

Установка через Docker (рекомендуется для простоты)

git clone https://github.com/giancbaring/msim
cd msim
docker-compose up

Это запускает AnythingLLM (официальный контейнер) на порту 3001 и MSIM на порту 8000 – всё уже предварительно настроено.

Использование

После установки запустите MSIM:

uv run python MSIM.py          # interactive menu
uv run python MSIM.py serve    # foreground server
uv run python MSIM.py start    # background daemon
uv run python MSIM.py stop     # stop daemon
uv run python MSIM.py status   # check status
uv run python MSIM.py logs     # view logs
uv run python MSIM.py install  # install as Windows service (NSSM)
uv run python MSIM.py uninstall # remove service

Конечные точки

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

Настройки хранятся в файле .env (создаётся во время установки). Вы также можете задать переменные окружения, чтобы переопределить их.

Ключевые переменные:

• ANYTHINGLLM_BASE_URL – по умолчанию http://localhost:3001

• ANYTHINGLLM_API_KEY – ваш Developer API Key

• CORS_ORIGINS – разделённые запятыми источники браузера, которым разрешён доступ к MSIM

• WORKSPACE – slug рабочей области по умолчанию (определяется автоматически, если пусто)

• PORT – порт сервера (по умолчанию 8000)

• MSIM_HOST – адрес привязки (по умолчанию 127.0.0.1; Docker использует 0.0.0.0)

• MSIM_ALLOW_LOCAL_FILE_UPLOAD – явно включает инструменты загрузки локальных файлов (по умолчанию false)

• LOG_FORMAT – plain или json

• SUPERVISE_MAX_RESTARTS – максимальное количество перезапусков в минуту (режим супервизора)

Участие в разработке

Не стесняйтесь открывать issues или pull requests на GitHub.

См. CONTRIBUTING.md, CODE_OF_CONDUCT.md и SECURITY.md, где описаны правила участия в разработке MSIM, нормы сообщества и политика безопасности. Вышестоящий субмодуль anythingllm-mcp имеет отдельные правила и атрибуцию.

Лицензия

Оригинальная работа MSIM распространяется под лицензией MIT; см. LICENSE, где приведены полные условия и уведомление о сфере действия.

Каталог submodules/anythingllm-mcp представляет собой независимо лицензируемый вышестоящий проект. Его условия авторского права, лицензии и атрибуции остаются в этом каталоге и применяются к указанному вышестоящему коду.