Memory server for AI Chat with MCP interface

MCP インターフェースを備えた AI チャット用メモリーサーバー

これは、AI チャット用メモリーサーバーのサンプルです。CleverChatty がサポートするインターフェースに準拠しています。

MCP サーバーのインターフェースは次のとおりです。

{
    "tools": [
    {
      "name": "remember",
      "description": "Remember a chat message to extract a context later for the memory",
      "inputSchema": {
        "properties": {
          "role": { "type": "string" },
          "message": { "type": "string" }
        },
        "required": ["role", "message"]
      }
    },
    {
      "name": "recall",
      "description": "Returns the summary of the previous conversations",
      "inputSchema": {
        "properties": {
        },
        "required": []
      }
    }
    ]
}

このツールは、CleverChatty CLI と組み合わせて、メモリー機能を備えた AI チャットを作成するために使用できます。サーバーはメッセージを記憶し、要求に応じて以前の会話の要約を返します。

サーバーの実行方法

1. リポジトリをクローンします

git clone [email protected]:Gelembjuk/cleverchatty-memory.git
cd cleverchatty-memory

2. まだインストールされていない場合は uv をインストールします

curl -Ls https://astral.sh/uv/install.sh | sh

3. 仮想環境を作成します

uv venv

4. Linux/macOS で仮想環境を有効にします（ほかのプラットフォームでは異なる場合があります）

source .venv/bin/activate

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

uv sync

6. サーバーを実行します

fastapi run mcp_server.py --port 8001

これにより、ポート 8001 で SSE トランスポートを使用する MCP サーバーが起動します。--port 引数を変更すると、ポートを変更できます。サーバーには URL http://localhost:8001/mcp からアクセスできます。--host 引数を使用してホストを変更することもできます。デフォルトでは、localhost からのみアクセスできます。--host 0.0.0.0 に変更すると、任意の IP アドレスからアクセスできるようになります。

テストとデバッグ

このツールには、サーバーをテストする CLI も含まれています。

python manager.py COMMAND

例：

python manager.py clear-memory
python manager.py remember "user" "Some message from user"
python manager.py remember "assistant" "Some response from assistant"
python manager.py patch-memories
python manager.py recall
python manager.py history-dump