2025-07-29 03:29:46 +09:00
2025-07-29 03:29:46 +09:00
2025-07-29 03:29:46 +09:00
2025-07-29 03:29:46 +09:00
2025-07-29 03:29:46 +09:00
2025-07-29 03:29:46 +09:00

aigpt - Claude Memory MCP Server

ChatGPTのメモリ機能を参考にした、Claude Desktop/Code用のシンプルなメモリストレージシステムです。

機能

  • メモリのCRUD操作: メモリの作成、更新、削除、検索
  • ChatGPT JSONインポート: ChatGPTの会話履歴からメモリを抽出
  • stdio MCP実装: Claude Desktop/Codeとの簡潔な連携
  • JSONファイル保存: シンプルなファイルベースのデータ保存

インストール

  1. Rustをインストールまだの場合:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  1. プロジェクトをビルド:
cargo build --release
  1. バイナリをパスの通った場所にコピー(オプション):
cp target/release/aigpt $HOME/.cargo/bin/
  1. Claude Code/Desktopに追加
# Claude Codeの場合
claude mcp add aigpt $HOME/.cargo/bin/aigpt server

# または
claude mcp add aigpt $HOME/.cargo/bin/aigpt serve

使用方法

ヘルプの表示

aigpt --help

MCPサーバーとして起動

# MCPサーバー起動 (どちらでも可)
aigpt server
aigpt serve

ChatGPT会話のインポート

# ChatGPT conversations.jsonをインポート
aigpt import path/to/conversations.json

Claude Desktop/Codeへの設定

  1. Claude Desktopの設定ファイルを開く:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json
  2. 以下の設定を追加:

{
  "mcpServers": {
    "aigpt": {
      "command": "/Users/syui/.cargo/bin/aigpt",
      "args": ["server"]
    }
  }
}

提供するMCPツール一覧

  1. create_memory - 新しいメモリを作成
  2. update_memory - 既存のメモリを更新
  3. delete_memory - メモリを削除
  4. search_memories - メモリを検索
  5. list_conversations - インポートされた会話を一覧表示

ツールの使用例

Claude Desktop/Codeで以下のように使用します

メモリの作成

MCPツールを使って「今日は良い天気です」というメモリーを作成してください

メモリの検索

MCPツールを使って「天気」に関するメモリーを検索してください

会話一覧の表示

MCPツールを使ってインポートした会話の一覧を表示してください

データ保存

  • デフォルトパス: ~/.config/syui/ai/gpt/memory.json
  • JSONファイルでデータを保存
  • 自動的にディレクトリとファイルを作成

データ構造

{
  "memories": {
    "uuid": {
      "id": "uuid",
      "content": "メモリーの内容",
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  },
  "conversations": {
    "conversation_id": {
      "id": "conversation_id",
      "title": "会話のタイトル",
      "created_at": "2024-01-01T00:00:00Z",
      "message_count": 10
    }
  }
}

開発

# 開発モードで実行
cargo run -- server

# ChatGPTインポートのテスト
cargo run -- import json/conversations.json

# テストの実行
cargo test

# フォーマット
cargo fmt

# Lintチェック
cargo clippy

トラブルシューティング

MCPサーバーが起動しない

# バイナリが存在するか確認
ls -la ~/.cargo/bin/aigpt

# 手動でテスト
echo '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}' | aigpt server

Claude Desktopでツールが見つからない

  1. Claude Desktopを完全に再起動
  2. 設定ファイルのパスが正しいか確認
  3. ログファイルを確認: ~/Library/Logs/Claude/mcp-server-aigpt.log

インポートが失敗する

# JSONファイルの形式を確認
head -100 conversations.json | jq '.[0] | keys'

ライセンス

MIT

Description
No description provided
Readme 9.8 MiB
Languages
Rust 100%