Memobase

🚀 MemoDB MCP サーバー

MCP サーバーは、AI アプリケーションの対話コンテキストと個人の知識ベースを管理するために使用されます。このサーバーは、モデルコンテキストプロトコル (MCP) を通じて、ユーザーデータ、対話内容、および知識管理のツールを提供します。

🚀 クイックスタート

MCP サーバーを使用することで、AI アプリケーションの対話コンテキストと個人の知識ベースを効果的に管理できます。以下の手順に従って、サーバーをセットアップしてください。

✨ 主な機能

1. ユーザー管理

• create_user: 新しいユーザーを作成します。
• get_user: ユーザー情報を取得します。
• update_user: ユーザー情報を更新します。
• delete_user: ユーザーを削除します。

2. 対話データ管理

• insert_blob: 対話データを挿入します。
• get_blob: 対話データを取得します。
• delete_blob: 対話データを削除します。

3. 知識ベース管理

• query_knowledge: 知識ベースをクエリします。
  • 全文検索をサポートします。
  • タイプ、タグ、ソースでのフィルタリングをサポートします。
  • 返される結果の数を制限することができます。
• add_knowledge: 新しい知識を追加します。
  • 知識のソースを設定することができます。
  • 知識のタイプを設定することができます。
  • タグを追加することができます。
• update_knowledge: 既存の知識を更新します。
  • 内容とメタデータの更新をサポートします。
  • タグの変更をサポートします。
• relate_knowledge: 知識の関連付けを作成します。
  • 関連付けのタイプを設定することができます。
  • 関連付けの重みを設定することができます。

🔧 技術詳細

1. 型安全

   • TypeScript で実装されています。
   • 完全な型定義とチェックがあります。
   • コンパイル時にエラーを検出します。

2. エラー処理

   • 包括的なエラー処理メカニズムがあります。
   • 詳細なエラー情報が提供されます。
   • エラーログが記録されます。

3. API 設計

   • JSON - RPC 2.0 プロトコルに基づいています。
   • RESTful API スタイルです。
   • 明確なインターフェース定義があります。

4. 拡張性

   • モジュール化設計です。
   • プラグイン式のツール登録が可能です。
   • 新しい機能を簡単に追加できます。

📦 インストール

1. 依存関係をインストールします:

npm install

2. 環境変数を設定します: .env ファイルを作成し、以下のように設定します。

MEMOBASE_API_URL=your_api_url    # API サーバーのアドレス
MEMOBASE_API_KEY=your_api_key    # API アクセスキー

3. プロジェクトをビルドします:

npm run build

4. サーバーを起動します:

# 本番環境
npm start

# 開発環境
npm run dev

💻 使用例

基本的な使用法

1. 知識の追加

const result = await callTool('add_knowledge', {
  uid: 'user123',
  content: '人工智能是计算机科学的一个分支...',
  metadata: {
    source: 'wiki',
    type: 'article',
    tags: ['AI', '计算机科学', '技术']
  }
});

2. 知識のクエリ

const result = await callTool('query_knowledge', {
  uid: 'user123',
  query: '人工智能',
  filters: {
    types: ['article'],
    tags: ['AI'],
    sources: ['wiki']
  },
  limit: 10
});

3. 知識の関連付け

const result = await callTool('relate_knowledge', {
  uid: 'user123',
  source_kid: 'knowledge1',
  target_kid: 'knowledge2',
  relation_type: 'related_to',
  weight: 0.8
});

📚 ドキュメント

開発ガイド

1. 新しいツールの追加

   • コードに新しい機能モジュールを追加します。
   • 既存の設計パターンと命名規則に従います。
   • モジュール間のインターフェース互換性を確保します。

2. 設定の変更

   • .env ファイルのパラメータ値を更新します。
   • 環境変数の名前を一致させます。
   • 異なる設定での実行結果をテストします。

3. テストの実行

   • npm test を使用して単体テストを実行します。
   • テストカバレッジレポートを確認します。
   • 定期的にテストケースを更新します。

よくある質問

• ヘルプを取得する方法は？ドキュメントを参照するか、サポートチームに問い合わせてください。
• エラーが発生した場合の対処方法は？ログファイルを確認し、トラブルシューティングガイドを参照してください。

📄 ライセンス

このプロジェクトは [許可証名] 契約に従います。詳細については、LICENSE ファイルを参照してください。