Memorymesh

🚀 メモリメッシュ（MemoryMesh）

MemoryMeshは、Claude Desktop上でMCPサーバーを統合するためのプロジェクトです。これを通じて、構造化データとAI推論能力を組み合わせることができます。本ドキュメントでは、MemoryMeshのインストール、設定、および使用方法について詳しく説明します。

🚀 クイックスタート

MemoryMeshを使うことで、Claude Desktop上でMCPサーバーを統合し、構造化データとAI推論能力を組み合わせることができます。以下のセクションでは、インストール、設定、使用方法などの詳細を説明します。

📦 インストール

ステップ1：ソースコードのダウンロード

以下のコマンドを使用してリポジトリをクローンし、ディレクトリに移動します。

git clone https://github.com/CheMiguel23/memorymesh.git
cd memorymesh

ステップ2：依存関係のインストール

プロジェクトのルートディレクトリで以下のコマンドを実行し、すべての依存関係をインストールします。

npm install

ステップ3：プロジェクトのビルド

TypeScriptコードをビルドし、実行可能ファイルを生成します。

npm run build

このコマンドにより、distディレクトリにJavaScriptファイルが生成され、サンプルデータとスキーマファイルが同ディレクトリにコピーされます。

ステップ4：Claude Desktopの設定

Claude Desktopの設定ファイルを編集し、以下の内容を追加します。

• macOS：パスは ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：パスは %APPDATA%\Claude\claude_desktop_config.json

mcpServersオブジェクトに以下の設定を追加します。

"memorymesh": {
  "command": "node",
  "args": ["/ABSOLUTE/PATH/TO/YOUR/PROJECT/memorymesh/dist/index.js"]
}

/ABSOLUTE/PATH/TO/YOUR/PROJECT/を実際のプロジェクトパスに置き換えてください。

ステップ5：Claude Desktopの再起動

設定が完了したら、アプリケーションを再起動して変更を有効にします。

📚 ドキュメント

インストールの検証

1. Claude Desktopを開きます。
2. 新しいチャットウィンドウを作成します。
3. 右上のMCPプラグインアイコンを確認します。アイコンが表示されていれば、サーバーが正常に接続されています。
4. アイコンをクリックし、memorymeshサービスがリストされているか確認します。
5. .hammer-iconをクリックし、add_npc、update_npcなどのツールが表示されるか確認します。

更新ガイド

更新を行う前に、dist/dataディレクトリ内のファイルを必ずバックアップしてください。これにより、データの損失を防ぐことができます。

トラブルシューティング

問題：Claude Desktopにサーバーが表示されない

• 設定ファイル内のパスが正しく、絶対パスであることを確認してください。
• distディレクトリが存在し、index.jsファイルが含まれていることを確認してください。
• エラー情報を取得するためにログファイルを確認してください。
  • macOS：パスは ~/Library/Logs/Claude/mcp-server-memorymesh.log
  • Windows：パスは %AppData%\Claude

問題：ツールが表示されない

• npm run buildコマンドが正常に実行されたことを確認してください。
• スキーマファイルがdist/data/schemasディレクトリに正しく配置され、命名規則（例：add_[entity].schema.json）に従っていることを確認してください。

高度な設定

変数

/config/config.tsファイルを使用して、デフォルト設定を上書きすることができます。

• MEMORY_FILE：知識グラフデータを格納するJSONファイルのパスを指定します（デフォルト値は dist/data/memory.json）。
• SCHEMAS_DIR：スキーマファイルのディレクトリパスを指定します（デフォルト値は dist/data/schemas/memory.json）。

制限事項

1. ノードの削除：AIは知識グラフからノードを削除することを望まない場合があります。