myAI メモリ同期

Name: myAI Memory Sync
Author: Jktfe

鍛冶屋のバッジ

新しいチャットを始めるたびに、Claudeに同じことを何度も繰り返すのはうんざりしていませんか？ myAI Memory Syncは、あなたの設定、個人情報、そしてコード標準をすべてのClaudeインターフェース間でシームレスに同期する、画期的なMCPツールです。一度アップデートするだけで、Claude DesktopからClaude Code、Windsurf、そしてClaude.ai Webまで、あらゆる場所に即座に変更が反映されます。最先端のキャッシュシステムにより、メモリ関連のクエリが最大2000倍高速化されます。繰り返しの指示にトークンを無駄にするのはもう終わり、真にパーソナライズされたAI体験をお楽しみください。

myAImemory-mcpと他のメモリツールの比較

AI システムには優れたメモリツールがいくつかありますが、myAImemory-mcp はモデルコンテキストプロトコル (MCP) ツールとして特定の目的を果たします。

道具	主な焦点	プライバシーモデル	統合	独自の強さ
myAImemory-mcp	Claude インターフェース全体のユーザー設定	ローカルファースト、外部サーバーにデータは送信されない	クロード固有のMCP	高性能キャッシュによるクロスプラットフォーム同期
グラフィティ	時間的知識グラフ	データベース依存	ジェネラルエージェントフレームワーク	知識表現における時間的認識
レッタ/MemGPT	ステートフルエージェントフレームワーク	サーバーベース	マルチモデルサポート	完全なエージェントアーキテクチャ
メモリ0	パーソナライズされたAIインタラクション	APIベース	マルチプラットフォーム	多段階のメモリ階層
メモリ	エージェントのための人間のような記憶	グラフデータベース	エージェント重視	人間の記憶のエミュレーション
コニエ	AIアプリ向けの信頼性の高いメモリ	複数のストレージオプション	データパイプラインに重点を置く	広範なデータソース統合

myAImemory-mcp の主な利点:

プライバシー優先: すべてのデータはデバイス上に残り、個人情報は外部サーバーに送信されません
パフォーマンス: Claude のキャッシュ機能を活用して速度を大幅に向上
シンプルさ: すべての Claude インターフェースで、好みに合わせて自然言語で更新します。
MCP統合:シームレスな統合を実現するClaude MCPとして特別に構築

Related MCP server: Union MCP

🚀 クイックスタート

# Clone repository git clone https://github.com/Jktfe/myaimemory-mcp.git cd myaimemory-mcp # Install dependencies npm install # Build TypeScript code npm run build # Start MCP server ./start-memory-sync.sh

🔄 直接同期方法（シンプルな代替手段）

MCP サーバーを実行する必要のないより簡単な方法としては、スタンドアロン同期スクリプトを使用できます。

# One-time sync of all memory files node sync-memory.js

このスクリプトは次のことを行います。

「myAI Master.md」ファイルから読み取ります
プロジェクト内のすべてのCLAUDE.mdファイルを更新します
Windsurfのメモリ設定を更新する
gitリポジトリに機密情報を保存することなく

🔒 プライバシーとセキュリティ

個人情報を含む「myAI Master.md」ファイルはgitの追跡から除外されます
プライバシー保護のため、CLAUDE.mdファイルもすべて除外されます。
.gitignoreを使って機密ファイルを非公開にしておく

次に、クロード語で次のように言います。

You: Use myAI Memory to remember I prefer TypeScript over JavaScript Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript.

📋 インストールオプション

オプション 1: 直接インストール (推奨)

npmからインストール:

npm install -g myai-memory-sync

サーバーを起動します。

myai-memory-sync

オプション2: ソースから実行

ソースからクローンしてビルドします:

git clone https://github.com/Jktfe/myaimemory-mcp.git cd myaimemory-mcp npm install npm run build npm start

オプション3: Docker

Docker でビルドして実行します。

docker build -t myai-memory-sync . docker run -v myai-memory:/app/data -p 3000:3000 myai-memory-sync

🔌 MCP 構成

クロードデスクトップ構成

これをclaude_desktop_config.jsonに追加します:

{ "mcpServers": { "myai-memory-sync": { "command": "npx", "args": [ "-y", "myai-memory-sync" ], "env": { "TEMPLATE_PATH": "/path/to/custom/template.md", "ENABLE_ANTHROPIC": "true", "ANTHROPIC_API_KEY": "your-api-key-here" } } } }

Claude.aiとSmithery

Smithery.aiにアクセス
myAI Memory Sync MCP を追加します。
@Jktfe/myaimemory-mcp
Smithery設定でAPIキーを設定します

ウィンドサーフィン統合

Windsurf では、 .codeium/config.jsonに以下を追加します。

{ "mcp": { "servers": { "myai-memory-sync": { "command": "npx", "args": [ "-y", "myai-memory-sync" ] } } } }

HTTPサーバーモード

stdio の代わりに HTTP トランスポートの場合:

# Start HTTP server on port 3000 npm run start:http # Or specify a custom port PORT=8080 npm run start:http

環境変数

次のオプションで.envファイルを作成します。

# Basic configuration DEBUG=true # Enable debug logging TEMPLATE_PATH=./data/template.md # Custom template location # Platform-specific paths WINDSURF_MEMORY_PATH=~/.codeium/windsurf/memories/global_rules.md CLAUDE_PROJECTS_PATH=~/CascadeProjects # Performance optimization ENABLE_ANTHROPIC=true # Enable Anthropic API integration ANTHROPIC_API_KEY=your-api-key # Your Anthropic API key ENABLE_PROMPT_CACHE=true # Enable prompt caching system CACHE_TTL=300000 # Cache TTL in milliseconds (5 minutes) # Claude web sync (optional) CLAUDE_WEB_SYNC_ENABLED=false # Enable Claude.ai web synchronization CLAUDE_WEB_EMAIL=you@email.com # Your Claude.ai email CLAUDE_WEB_HEADLESS=true # Run browser in headless mode

🧙‍♂️ システムプロンプトの統合

最良の結果を得るには、Claude システムプロンプトに以下を追加します。

Memory Integration Instructions: When you receive a command that starts with "use myAI Memory to", you should: 1. Process the rest of the instruction as a memory management command 2. Try to determine the appropriate section to update based on the content 3. Use the myAI Memory Sync MCP to update your memory 4. Confirm the update with a brief acknowledgment For example: "use myAI Memory to remember I prefer dark mode" → Update the preferences section with dark mode preference When asked questions about preferences or personal information, first check your memory via the myAI Memory Sync MCP. Always reference information from memory rather than making assumptions.

✨ 特徴

🔄クロスプラットフォーム同期：一度更新すればどこでも同期されます
⚡超高速リコール：最大2000倍のパフォーマンス向上を実現するキャッシュシステム
🗣️自然言語インターフェース：自然に話すだけで設定を更新できます
🧩複数のペルソナプロファイル：さまざまなプリセットを簡単に切り替えることができます
🔐セキュリティ重視：.gitignore 保護付きのローカルストレージ
🛠️開発者向け: 包括的な API を備えた完全な TypeScript 実装

🧩 コアアーキテクチャ

myAI Memory Sync は、次の主要コンポーネントを備えたモジュラーアーキテクチャを使用します。

テンプレートパーサー: 構造化メモリオブジェクトとマークダウン間の双方向変換
テンプレートストレージ: メモリ内およびファイルシステムキャッシュを備えた永続ストレージ
プラットフォーム同期化: 各ターゲットプラットフォームのPlatformSyncerインターフェースを実装します。
自然言語プロセッサ:自然言語メモリコマンドから構造化されたデータを抽出します
メモリキャッシュサービス: マルチレベルキャッシュ戦略でパフォーマンスを最適化します

🔍 詳細な機能

クロスプラットフォーム同期

ClaudeCodeSyncer : すべてのリポジトリのCLAUDE.mdファイルを更新します
WindsurfSyncer : Windsurf 環境で global_rules.md を管理します
ClaudeWebSyncer : Claude.ai ウェブインターフェースとのオプションの Puppeteer ベースの同期

インテリジェントなメモリ管理

パターンベースの抽出:自然言語を構造化されたキーと値のペアに変換します
セクション検出アルゴリズム: 新しいメモリに適切なセクションを自動的に決定します
メモリテンプレート形式: セクション、説明、キー値項目を含むマークダウンベースの構造
コンテキスト保存: テンプレートの他のコンテンツを保存しながらメモリセクションを更新します

パフォーマンスの最適化

マルチレベルキャッシュ: テンプレートとセクションレベルの両方でメモリ内キャッシュ
TTLベースのキャッシュ管理: キャッシュされたコンテンツの有効期限を設定可能
事前ウォーミング: テンプレートの更新後にキャッシュを事前設定する
オプションのAnthropic API統合：メモリ関連のクエリを最大2000倍高速化

安全

ローカルファーストアーキテクチャ：すべてのデータはデバイス上に残ります
Gitignore 管理: すべてのリポジトリの .gitignore に CLAUDE.md を自動的に追加します
ファイル権限処理: 最大限の互換性を確保するために権限の問題を修正
暗号化ストレージ: 暗号化ファイルシステムと互換性があります

📋 メモリテンプレートの形式

システムは、構造化されたマークダウン形式を使用して設定を整理します。

# myAI Memory # User Information ## Use this information if you need to reference them directly -~- Name: Your Name -~- Location: Your Location -~- Likes: Reading, Hiking, Technology # General Response Style ## Use this in every response -~- Style: Friendly and concise -~- Use UK English Spellings: true -~- Include emojis when appropriate: true # Coding Preferences ## General Preference when responding to coding questions -~- I prefer TypeScript over JavaScript -~- Show step-by-step explanations

🛠️ 技術的な実装

メモリテンプレートスキーマ

interface MemoryTemplate { sections: TemplateSection[]; } interface TemplateSection { title: string; description: string; items: TemplateItem[]; } interface TemplateItem { key: string; value: string; }

プラットフォーム同期インターフェース

interface PlatformSyncer { sync(templateContent: string): Promise<SyncStatus>; } type PlatformType = 'claude-web' | 'claude-code' | 'windsurf' | 'master'; interface SyncStatus { platform: PlatformType; success: boolean; message: string; }

🔌 MCP 統合 API

myAI Memory Sync ツールは、次の機能を使用してモデルコンテキストプロトコル (MCP) を実装します。

関数	説明	パラメータ
`get_template`	完全なメモリテンプレートを取得します	なし
`get_section`	特定のセクションを取得します	`sectionName: string`
`update_section`	特定のセクションを更新します	`sectionName: string, content: string`
`update_template`	テンプレート全体を置き換えます	`content: string`
`list_presets`	利用可能なプリセットを一覧表示します	なし
`load_preset`	特定のプリセットをロードします	`presetName: string`
`create_preset`	新しいプリセットを作成します	`presetName: string`
`sync_platforms`	プラットフォーム間で同期	`platform?: string`
`list_platforms`	利用可能なプラットフォームの一覧	なし

自然言語インターフェース

ユーザーは自然言語コマンドを通じてシステムと対話できます。

You: Use myAI Memory to remember I prefer TypeScript over JavaScript Claude: ✅ Added to your Coding Preferences! I'll remember you prefer TypeScript over JavaScript. You: Use myAI Memory to load preset developer Claude: ✅ Loaded developer preset! I'll now use your developer preferences.

🧙‍♂️ 高度な使い方

メモリプリセット

さまざまなペルソナを簡単に切り替えます。

You: Use myAI Memory to list presets Claude: Available presets: personal, work, developer You: Use myAI Memory to load preset developer Claude: ✅ Loaded developer preset!

緊急同期

すべてのプラットフォーム間での同期の問題を修正する必要がある場合:

# Sync everything immediately ./emergency-sync.sh

コマンドラインインターフェース

# View all available commands node dist/cli.js --help # Process memory commands directly node dist/cli.js --remember "remember I prefer dark mode" # Start HTTP server for SSE transport npm run start:http # Start stdio server for MCP transport npm run start

開発ワークフロー

# Run in development mode with auto-reload npm run dev # Run in development mode with HTTP server npm run dev:http # Watch TypeScript compilation npm run build:watch # Run tests npm test # Run specific test npm test -- -t "platformSync" # Lint code npm run lint # Type check without emitting files npm run typecheck

⚡ パフォーマンスベンチマーク

当社のキャッシュシステムは、パフォーマンスを大幅に向上させます。

手術	キャッシュなし	キャッシュあり	改善
メモリクエリ	約2000ミリ秒	約1ミリ秒	2000x
セクション検索	約1600ミリ秒	約0.8ミリ秒	2000x
テンプレート解析	約120ミリ秒	約0.1ミリ秒	1200倍
プラットフォーム同期	約850ミリ秒	約350ミリ秒	2.4倍

🔒 セキュリティとプライバシー

当社はあなたのプライバシーを真剣に受け止めます:

すべてのデータはデバイス上にローカルに保存されます
CLAUDE.mdファイルは自動的に.gitignoreに追加されます。
データは外部サーバーに送信されません（オプションの Anthropic API 統合を使用する場合を除く）
暗号化されたファイルシステムで動作し、最大限のセキュリティを実現します

🛠️ トラブルシューティング

よくある問題

CLAUDE.md が更新されない
- ls -la CLAUDE.mdでファイルの権限を確認します。
- ./emergency-sync.shで緊急同期を試してください
- .envファイル内のプラットフォームパスを確認する
MCP接続失敗
- ps aux | grep myai-memoryで MCP サーバーが実行中であることを確認します。
- Claude Desktop のログで MCP エラーを確認します
- Claude Desktop の構成ファイルを確認する
キャッシュの問題
- node dist/cli.js --clear-cacheでキャッシュをクリアします。
- Anthropic APIキーが正しく設定されていることを確認する
- node dist/cli.js --validateでメモリファイルの整合性をチェックします。

ログとデバッグ

詳細なログを表示するにはデバッグモードを有効にします。

DEBUG=true npm run start

ログファイルは次の場所に保存されます:

Linux/macOS: ~/.local/share/myai-memory/logs/
Windows: %APPDATA%\myai-memory\logs\

🤝 貢献する

貢献を歓迎します！お気軽にプルリクエストを送信してください。

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

私たちは標準の Git ワークフローと CI プロセスに従います。

すべてのPRはテストとリンティングに合格する必要がある
新しい機能にはテストを含める必要がある
大きな変更があった場合はドキュメントを更新する必要がある
既存のコードスタイルとパターンに従う

📚 ドキュメント

より詳細なドキュメントについては、 Wikiを参照してください。

API ドキュメントは/docsディレクトリにあります。

# Generate API documentation npm run docs

📄 ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。

📬 お問い合わせ

プロジェクトリンク: https://github.com/Jktfe/myaimemory-mcp