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）。

• 自动工作区检测 – 未指定时使用第一个工作区。

• 交互式设置 – 首次运行时会询问 AnythingLLM API 密钥、基础 URL 和工作区。

• 结构化日志与轮转 – JSON 或纯文本日志，支持自动轮转。

• 优雅关闭 – 等待正在进行的工具调用完成。

• 守护模式 – 崩溃时自动重启（可限制）。

• 端点横幅 – 启动时显示所有可用 URL。

• Docker 支持 – 可与 AnythingLLM 一起通过 docker-compose up 运行。

• 跨平台 – 支持 Windows、macOS、Linux。

Related MCP server: anythingllm-mcp

安装

前提条件

• Git（用于克隆仓库）

• AnythingLLM – 在本地运行（桌面版或 Docker），并具有开发者 API 密钥（在“设置 → 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 上提交 issue 或 pull request。

请参阅 CONTRIBUTING.md、CODE_OF_CONDUCT.md 和 SECURITY.md，了解 MSIM 的贡献、社区和安全政策。上游 anythingllm-mcp 子模块有单独的政策和归属说明。

许可证

MSIM 的原始工作以 MIT 许可证发布；请参阅 LICENSE 了解完整条款和范围说明。

submodules/anythingllm-mcp 目录是一个独立许可的上游 项目。其版权、许可证和归属条款保留在该目录中， 并适用于该上游代码。