MCP Brain Server

🚀 腦部服務器指南

腦部服務器是基於模型上下文協議（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：運行代碼檢查工具