MSIM – MCP Server Integration Manager

MSIM es un servidor MCP (Model Context Protocol) unificado que conecta AnythingLLM con cualquier cliente compatible con MCP (Better DeepSeek, Claude Desktop, Cursor, VS Code, agentes personalizados).

Proporciona un único endpoint para los transportes HTTP/JSON‑RPC, SSE y WebSocket, y gestiona automáticamente la selección del workspace, el registro de logs y el funcionamiento en segundo plano.

Características

• Soporte MCP completo – initialize, tools/list, tools/call, notifications/initialized, ping, prompts/list, resources/list.

• Multitransporte – HTTP (/mcp), SSE (/sse), WebSocket (/ws).

• Detección automática del workspace – utiliza el primer workspace si no se especifica.

• Configuración interactiva – en la primera ejecución solicita la API key de AnythingLLM, la URL base y el workspace.

• Registro estructurado y rotación – logs en JSON o texto plano con rotación automática.

• Apagado ordenado – espera a que las llamadas a herramientas en curso finalicen.

• Modo supervisor – se reinicia automáticamente ante un fallo (limitable).

• Banner de endpoints – muestra todas las URLs disponibles al iniciar.

• Soporte Docker – se ejecuta con docker-compose up junto a AnythingLLM.

• Multiplataforma – funciona en Windows, macOS y Linux.

Related MCP server: AnythingLLM MCP Server

Instalación

Requisitos previos

• Git (para clonar el repositorio)

• AnythingLLM – ejecutándose localmente (Desktop o Docker) con una Developer API Key (genérala en Settings → API Keys).

Instalación rápida (manual)

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

El instalador:

1. Instala uv (si no está instalado).

2. Instala Python 3.12 mediante uv (si no está instalado).

3. Elimina el entorno virtual anterior.

4. Instala todas las dependencias de Python (incluido el wrapper).

5. Valida el código.

6. Ejecuta la configuración interactiva (solicita API key, URL base y workspace).

Instalación con Docker (recomendada por su simplicidad)

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

Esto inicia AnythingLLM (contenedor oficial) en el puerto 3001 y MSIM en el puerto 8000 – todo está preconfigurado.

Uso

Tras la instalación, ejecuta 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

Endpoints

Configuración

Los ajustes se guardan en .env (creado durante la configuración). También puedes definir variables de entorno para sobrescribirlos.

Variables principales:

• ANYTHINGLLM_BASE_URL – por defecto http://localhost:3001

• ANYTHINGLLM_API_KEY – tu Developer API Key

• CORS_ORIGINS – orígenes de navegador separados por comas permitidos para acceder a MSIM

• WORKSPACE – slug del workspace por defecto (se detecta automáticamente si está vacío)

• PORT – puerto del servidor (por defecto 8000)

• MSIM_HOST – dirección de bind (por defecto 127.0.0.1; Docker usa 0.0.0.0)

• MSIM_ALLOW_LOCAL_FILE_UPLOAD – habilita explícitamente las herramientas de subida de archivos locales (por defecto false)

• LOG_FORMAT – plain o json

• SUPERVISE_MAX_RESTARTS – máximo de reinicios por minuto (modo supervisor)

Contribuciones

No dudes en abrir issues o pull requests en GitHub.

Consulta CONTRIBUTING.md, CODE_OF_CONDUCT.md y SECURITY.md para conocer las políticas de contribución, comunidad y seguridad de MSIM. El submódulo upstream anythingllm-mcp tiene políticas y atribución independientes.

Licencia

El trabajo original de MSIM se publica bajo la Licencia MIT; consulta LICENSE para conocer los términos completos y el aviso de alcance.

El directorio submodules/anythingllm-mcp es un proyecto upstream con licencia independiente. Sus términos de copyright, licencia y atribución permanecen en ese directorio y se aplican a ese código upstream.