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: コードチェックツールを実行します。