🚀 脑部服务器指南

脑部服务器是基于模型上下文协议（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：运行代码检查工具