Brain Server - MCP Knowledge Embedding Service
2025.04.14
0
TypeScript知识管理语义搜索AI 集成开发效率
Brain Server 是一个基于 MCP（Model Context Protocol）的知识嵌入和向量搜索服务，主要用于管理和检索知识内容。它支持高质量的向量嵌入生成、语义搜索、知识组织以及上下文感知检索等功能。
View on GitHub
Overview
基本能力
产品定位
Brain Server 是一个强大的 MCP 服务器，专注于知识嵌入和向量搜索，旨在为 AI 模型提供高效的知识管理和检索能力。
核心功能
- 向量嵌入：为知识内容生成高质量的向量表示
- 语义搜索：基于语义而非关键词进行知识检索
- MCP 兼容：遵循 Model Context Protocol，便于 AI 集成
- 知识管理：将知识组织到特定领域的“大脑”中
- 上下文感知检索：包含周围上下文以提升理解
- 进度跟踪：实时监控长时间运行的操作
适用场景
- AI 知识库管理
- 语义搜索系统
- 上下文感知的 AI 应用
- 知识组织和检索
工具列表
addKnowledge：向向量数据库添加新知识searchSimilar：查找语义相似的内容updateKnowledge：更新现有知识条目deleteKnowledge：删除知识条目batchAddKnowledge：批量添加多个知识条目getEmbedding：为文本内容生成嵌入向量
常见问题解答
- Docker 问题：检查容器日志、确保端口映射正确、验证 MongoDB 是否在容器中运行
- MongoDB 连接问题：验证 MongoDB 是否运行、检查日志、确保防火墙允许连接
- 缺少向量索引能力：确保使用 MongoDB 6.0+ 以获得最佳向量搜索支持
使用教程
使用依赖
MongoDB 安装（推荐使用 Docker）
Ubuntu/Debian
wget -qO - https://www.mongodb.org/static/pgp/server-6.0.asc | sudo tee /etc/apt/trusted.gpg.d/mongodb-6.0.asc
echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/6.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-6.0.list
sudo apt-get update
sudo apt-get install -y mongodb-org
sudo systemctl start mongod
macOS
brew tap mongodb/brew
brew install [email protected]
brew services start [email protected]
Windows
- 从 MongoDB Download Center 下载 MongoDB 6.0 安装程序
- 运行安装程序并按照向导设置
- 从 Windows 服务控制台启动 MongoDB
安装教程
使用 Docker 快速启动
git clone https://github.com/patrickdeluca/mcp-brain-server.git
cd mcp-brain-server
docker-compose up -d
docker-compose logs -f
手动安装
git clone https://github.com/patrickdeluca/mcp-brain-server.git
cd mcp-brain-server
npm install
cp .env.example .env
npm run build
调试方式
启动服务器
npm run dev # 开发模式
npm start # 生产模式
使用 MCP Inspector 调试
npx @modelcontextprotocol/inspector node dist/index.js