脑部服务器指南

概述

脑部服务器是一个基于模型上下文协议（MCP）的知识嵌入服务。它提供了多种功能，包括向量嵌入、语义搜索和知识管理。本指南将详细介绍如何使用和部署该服务器。

安装指南

使用Docker安装

docker build -t mcp-brain-server .
docker run -p 3000:3000 -d --name brain-server mcp-brain-server

手动安装

1. 克隆仓库：

   git clone https://github.com/your-repository.git
   cd mcp-brain-server
   

2. 安装依赖：

   npm install
   

3. 启动服务器：

   npm start
   

使用说明

可用资源

• embedding_config：当前嵌入配置
• embedding_models：可用的嵌入模型及其配置
• service_status：嵌入服务的状态

工具示例

添加知识

{
  "content": "模型上下文协议（MCP）是AI模型与外部系统交互的标准接口。",
  "metadata": {
    "brainId": "tech-knowledge",
    "userId": "user123",
    "source": "文档",
    "type": "定义"
  }
}

搜索相似内容

{
  "query": "什么是MCP？",
  "options": {
    "limit": 5,
    "minConfidence": 0.7,
    "filters": {
      "metadata.brainId": "tech-knowledge"
    }
  }
}

项目结构

src/
├── config/          # 配置设置
├── controllers/     # 路由控制器
├── errors/          # 错误定义
├── middleware/      # Express中间件
├── models/          # 数据模型和类型
├── services/        # 业务逻辑
│   ├── embeddings/  # 嵌入提供程序
│   ├── ingestion/   # 知识摄入
│   ├── processing/  # 知识处理
│   └── storage/     # 存储服务
├── tools/           # MCP工具定义
├── types/           # TypeScript类型定义
├── utils/           # 工具函数
├── server.ts        # MCP服务器设置
└── index.ts         # 应用入口点

脚本命令

• npm run build：构建TypeScript项目
• npm start：运行已构建的应用程序
• npm run dev：以开发模式运行，支持热重载
• npm test：运行测试
• npm run lint：运行代码检查工具