Zannyの永続メモリマネージャ

永続メモリバンクとして機能するカスタムMCP（モデル機能プロバイダー）サーバー。TypeScriptベースのこのサーバーでは、柔軟なキーワード検出とコマンドを使用して、メモリを保存、取得、管理できます。

特徴

• 思い出を保存: テキストベースの情報を保存して、後で取り出すことができます
• 思い出の取得: コンテンツまたはIDで保存された思い出を検索して取得します
• 思い出を削除: 不要になった思い出を削除します
• スマートキーワード検出:自然言語で関連するコマンドを自動的に検出します
• 無制限のストレージ: メモリストレージのサイズに人為的な制限はありません
• 包括的なログ記録:トラブルシューティングと監視のための詳細なログ記録
• MCP 互換性: Smithery.ai デプロイメント用の完全な JSON-RPC 実装

インストール

1. システムにNode.jsとnpmがインストールされていることを確認してください
2. プロジェクトの依存関係をインストールします。
   npm install
3. TypeScript プロジェクトをビルドします。
   npm run build

使用法

サーバーの起動

次のコマンドでサーバーを起動します。

デフォルトでは、サーバーはポート 3000 でリッスンを開始します。

APIエンドポイント

REST API（レガシー）

• GET /health - サーバーの健全性をチェックする
• POST /api/memories - 新しいメモリを保存する
• GET /api/memories - 思い出を一覧表示または検索する
• GET /api/memories/:id - 特定のメモリを取得する
• DELETE /api/memories/:id - メモリを削除する
• POST /api/detect - テキスト内のトリガーキーワードを検出する

JSON-RPC エンドポイント (MCP 互換)

• POST /tools/list - 利用可能なツールを一覧表示する
• POST /tools/call - 特定のツールを呼び出す

メモリコマンド

MCP サーバーは、メモリ管理に関連する自然言語コマンドを理解します。例:

記憶を保存する

記憶を取り戻す

記憶の消去

すべての思い出を一覧表示する

プロジェクト構造

構成

設定はsrc/config.tsで管理されます。主な設定は次のとおりです。

• サーバー名
• サーバーポート
• 思い出ディレクトリ
• ロガーの設定
• トリガーキーワード

Smithery.aiへのデプロイ

このMCPサーバーはSmithery.aiのデプロイメントと互換性があります。デプロイするには：

1. コードがGitリポジトリにあることを確認してください
2. Smithery.aiアカウントをお持ちでない場合は作成してください
3. リポジトリをSmithery.aiに接続する
4. 同梱のsmithery.jsonファイルはデプロイメントプロセスをガイドします

ログ記録

ログはlogs/ディレクトリに保存されます。MCP仕様との互換性を確保するため、すべてのログはJSON形式でフォーマットされます。

ライセンス

ISC