MaxKB

by 1Panel-dev

22k stars

2.4k downloads

Not rated

GitHub Website

About

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

Details

Author: 1Panel-dev
GitHub stars: 21,956
Downloads: 2,381
Categories: Other, Knowledge Base, AI

- RAG pipeline with document upload and automatic crawling.
- Agentic workflow with a powerful engine, function library, and MCP tools.
- Zero-coding integration into third-party business systems.
- Supports private models (DeepSeek, Llama, Qwen) and public models (OpenAI, Claude, Gemini, MiniMax).
- Native support for text, image, audio, and video input/output.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name MaxKB

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

From the repository

Run a Docker container: docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb. Access the web interface at http://your_server_ip:8080 and log in with username admin and password MaxKB@123...

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "maxkb": {
            "MaxKB": {
                "command": "docker",
                "args": [
                    "run",
                    "-d",
                    "--name=maxkb",
                    "--restart=always",
                    "-p",
                    "8080:8080",
                    "-v",
                    "~/.maxkb:/opt/maxkb",
                    "1panel/maxkb"
                ]
            }
        }
    }
}

McpServers

{
    "MaxKB": {
        "command": "docker",
        "args": [
            "run",
            "-d",
            "--name=maxkb",
            "--restart=always",
            "-p",
            "8080:8080",
            "-v",
            "~/.maxkb:/opt/maxkb",
            "1panel/maxkb"
        ]
    }
}

<p align="center"><img src= "https://github.com/1Panel-dev/maxkb/assets/52996290/c0694996-0eed-40d8-b369-322bf2a380bf" alt="MaxKB" width="300" /></p> <h3 align="center">Open-source platform for building enterprise-grade agents</h3> <h3 align="center">强大易用的企业级智能体平台</h3> <p align="center"><a href="https://trendshift.io/repositories/9113" target="_blank"><img src="https://trendshift.io/api/badge/repositories/9113" alt="1Panel-dev%2FMaxKB | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a></p> <p align="center"> <a href="https://www.gnu.org/licenses/gpl-3.0.html#license-text"><img src="https://img.shields.io/github/license/1Panel-dev/maxkb?color=%231890FF" alt="License: GPL v3"></a> <a href="https://github.com/1Panel-dev/maxkb/releases/latest"><img src="https://img.shields.io/github/v/release/1Panel-dev/maxkb" alt="Latest release"></a> <a href="https://github.com/1Panel-dev/maxkb"><img src="https://img.shields.io/github/stars/1Panel-dev/maxkb?color=%231890FF&style=flat-square" alt="Stars"></a> <a href="https://hub.docker.com/r/1panel/maxkb"><img src="https://img.shields.io/docker/pulls/1panel/maxkb?label=downloads" alt="Download"></a><br/> [<a href="/README_CN.md">中文(简体)</a>] | [<a href="/README.md">English</a>] </p> <hr/> MaxKB = Max Knowledge Brain, it is an open-source platform for building enterprise-grade agents. MaxKB integrates Retrieval-Augmented Generation (RAG) pipelines, supports robust workflows, and provides advanced MCP tool-use capabilities. MaxKB is widely applied in scenarios such as intelligent customer service, corporate internal knowledge bases, academic research, and education. - **RAG Pipeline**: Supports direct uploading of documents / automatic crawling of online documents, with features for automatic text splitting, vectorization. This effectively reduces hallucinations in large models, providing a superior smart Q&A interaction experience. - **Agentic Workflow**: Equipped with a powerful workflow engine, function library and MCP tool-use, enabling the orchestration of AI processes to meet the needs of complex business scenarios. - **Seamless Integration**: Facilitates zero-coding rapid integration into third-party business systems, quickly equipping existing systems with intelligent Q&A capabilities to enhance user satisfaction. - **Model-Agnostic**: Supports various large models, including private models (such as DeepSeek, Llama, Qwen, etc.) and public models (like OpenAI, Claude, Gemini, MiniMax, etc.). - **Multi Modal**: Native support for input and output text, image, audio and video. ## Quick start Execute the script below to start a MaxKB container using Docker: ```bash docker run -d --name=maxkb --restart=always -p 8080:8080 -v ~/.maxkb:/opt/maxkb 1panel/maxkb ``` Access MaxKB web interface at `http://your_server_ip:8080` with default admin credentials: - username: admin - password: MaxKB@123.. 中国用户如遇到 Docker 镜像 Pull 失败问题，请参照该 [离线安装文档](https://maxkb.cn/docs/v2/installation/offline_installtion/) 进行安装。 ## Screenshots <table style="border-collapse: collapse; border: 1px solid black;"> <tr> <td style="padding: 5px;background-color:#fff;"><img src= "https://github.com/user-attachments/assets/eb285512-a66a-4752-8941-c65ed1592238" alt="MaxKB Demo1" /></td> <td style="padding: 5px;background-color:#fff;"><img src= "https://github.com/user-attachments/assets/f732f1f5-472c-4fd2-93c1-a277eda83d04" alt="MaxKB Demo2" /></td> </tr> <tr> <td style="padding: 5px;background-color:#fff;"><img src= "https://github.com/user-attachments/assets/c927474a-9a23-4830-822f-5db26025c9b2" alt="MaxKB Demo3" /></td> <td style="padding: 5px;background-color:#fff;"><img src= "https://github.com/user-attachments/assets/e6268996-a46d-4e58-9f30-31139df78ad2" alt="MaxKB Demo4" /></td> </tr> </table> ## Technical stack - Frontend：[Vue.js](https://vuejs.org/) - Backend：[Python / Django](https://www.djangoproject.com/) - LLM Framework：[LangChain](https://www.langchain.com/) - Database：[PostgreSQL + pgvector](https://www.postgresql.org/) ## Star History [![Star History Chart](https://api.star-history.com/svg?repos=1Panel-dev/MaxKB&type=Date)](https://star-history.com/#1Panel-dev/MaxKB&Date) ## License Licensed under The GNU General Public License version 3 (GPLv3) (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at <https://www.gnu.org/licenses/gpl-3.0.html> Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

MaxKB

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

Claude Desktop / Cursor

McpServers

Install

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Install

More like this

Sequential Thinking

Aws Kb Retrieval Server

Memory

Filesystem

EverArt

Google Drive