MSIM – MCP 서버 통합 관리자

MSIM은 AnythingLLM과 MCP 호환 클라이언트(Better DeepSeek, Claude Desktop, Cursor, VS Code, 사용자 정의 에이전트)를 연결하는 통합 MCP(Model Context Protocol) 서버입니다.

HTTP/JSON‑RPC, SSE, WebSocket 전송을 위한 단일 엔드포인트를 제공하며, 작업 공간 선택, 로깅, 백그라운드 운영을 자동으로 관리합니다.

기능

• 전체 MCP 지원 – initialize, tools/list, tools/call, notifications/initialized, ping, prompts/list, resources/list.

• 다중 전송 – HTTP(/mcp), SSE(/sse), WebSocket(/ws).

• 자동 작업 공간 감지 – 지정되지 않은 경우 첫 번째 작업 공간을 사용합니다.

• 대화형 설정 – 첫 실행 시 AnythingLLM API 키, 기본 URL, 작업 공간을 묻습니다.

• 구조화된 로깅 및 로테이션 – 자동 로테이션이 적용된 JSON 또는 일반 텍스트 로그.

• 정상 종료 – 진행 중인 도구 호출이 완료될 때까지 대기합니다.

• 슈퍼바이저 모드 – 충돌 시 자동 재시작(제한 가능).

• 엔드포인트 배너 – 시작 시 사용 가능한 모든 URL을 표시합니다.

• Docker 지원 – AnythingLLM과 함께 docker-compose up으로 실행됩니다.

• 크로스 플랫폼 – Windows, macOS, Linux에서 작동합니다.

Related MCP server: anythingllm-mcp

설치

사전 요구 사항

• Git(리포지토리 클론용)

• AnythingLLM – 개발자 API 키가 있는 로컬 실행 환경(Desktop 또는 Docker). (설정 → API 키에서 생성)

빠른 설치(수동)

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

설치 프로그램은 다음을 수행합니다:

1. uv를 설치합니다(없는 경우).

2. uv를 통해 Python 3.12를 설치합니다(없는 경우).

3. 이전 가상 환경을 제거합니다.

4. 모든 Python 종속성을 설치합니다(래퍼 포함).

5. 코드를 검증합니다.

6. 대화형 설정을 실행합니다(API 키, 기본 URL, 작업 공간을 묻습니다).

Docker 설치(간편함을 위해 권장)

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

이 명령은 포트 3001에서 AnythingLLM(공식 컨테이너)을, 포트 8000에서 MSIM을 시작합니다. 모든 것이 사전 구성되어 있습니다.

사용 방법

설치 후 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 – 개발자 API 키

• 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 – 분당 최대 재시작 횟수(슈퍼바이저 모드)

기여

GitHub에 이슈나 풀 리퀘스트를 자유롭게 열어 주세요.

MSIM 기여, 커뮤니티, 보안 정책은 CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md를 참조하세요. 업스트림 anythingllm-mcp 서브모듈에는 별도의 정책과 저작자 표시가 있습니다.

라이선스

원본 MSIM 작업은 MIT 라이선스로 배포됩니다. 전체 약관과 범위 고지는 LICENSE를 참조하세요.

submodules/anythingllm-mcp 디렉터리는 독립적으로 라이선스가 부여된 업스트림 프로젝트입니다. 해당 디렉터리에 저작권, 라이선스, 저작자 표시 조건이 유지되며 업스트림 코드에 적용됩니다.