Memory MCP Server Go

🚀 メモリMCPサーバのGo実装

このプロジェクトは、メモリMCPサーバをGo言語で実装したものです。サーバのインストール、設定、使用方法を提供し、AIアシスタントの長期記憶や知識管理などのシナリオでの利用をサポートします。

🚀 クイックスタート

このセクションでは、メモリMCPサーバを迅速にセットアップして使用する方法を説明します。

📦 インストール

快速インストール

最新バージョンをインストールするには、以下のコマンドを実行します。

go install github.com/mark3labs/memory-mcp-server-go@latest

手動構築

手動で構築する場合は、以下の手順に従ってください。

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

git clone https://github.com/mark3labs/memory-mcp-server-go.git
cd memory-mcp-server-go

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

go mod tidy

3. バイナリファイルを構築します。

go build -o bin/memory-mcp-server-go .

💻 使用例

基本的な使用法

サーバの起動

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

memory-mcp-server-go --port 5001

設定

デフォルト設定

• リスニングアドレス：localhost
• ポート：5001
• データファイルパス：カレントディレクトリの memory.json

サンプルコマンド

• エンティティの作成

memory-mcp-server-go --port 5001 create_entities '{"name":"John Smith","entityType":"Person","observations":["Software engineer","Lives in San Francisco","Enjoys hiking"]}'

• 関係の作成

memory-mcp-server-go --port 5001 create_relations '{"from":"John Smith","to":"Acme Corp","relationType":"works at"}'

高度な使用法

知識グラフ構造

エンティティ

{
  "entities": [
    {
      "name": "John Smith",
      "entityType": "Person",
      "observations": ["Software engineer", "Lives in San Francisco", "Enjoys hiking"]
    }
  ]
}

関係

{
  "relations": [
    {
      "from": "John Smith",
      "to": "Acme Corp",
      "relationType": "works at"
    }
  ]
}

使用シナリオ

• AIアシスタントの長期記憶：AIアシスタントがユーザーの嗜好、過去のやり取り、重要な事実を記憶できるようにします。
• 知識管理：人、場所、イベント、概念に関する情報を整理します。
• 関係追跡：エンティティ間の関係ネットワークを維持します。
• コンテキストの永続化：複数のセッションにわたって重要なコンテキストを保持します。

設定例

Claude.app用の設定

Claudeの設定に以下の内容を追加します。

"mcpServers": {
  "memory": {
    "command": "memory-mcp-server-go",
    "env": {
      "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
    }
  }
}

Cursor用の設定

Cursorの設定の mcp.json に以下の内容を追加します。

{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server-go",
      "env": {
        "MEMORY_FILE_PATH": "/Path/Of/Your/memory.json"
      }
    }
  }
}

システムプロンプトの例

Claudeがmemory-mcp-serverをより効果的に利用できるように、以下のシステムプロンプトを使用できます。

あなたには、会話中の情報を保存して検索できる知識グラフ記憶システムがあります。このシステムを使用して、重要なコンテキストと関連付けを記憶してください。

メモリファイルパス

• デフォルトパス：./memory.json
• 環境変数 MEMORY_FILE_PATH でカスタマイズ可能です。

エラー処理

一般的なエラー

1. ファイルが存在しない場合

   • ファイルパスが正しいか確認してください。
   • 新しいファイルを初期化するには、touch memory.json を実行します。

2. ポートが使用中の場合

   • エラーメッセージ アドレスが既に使用されています をキャッチします。
   • 別のポートを試すには、--port 5002 を使用します。

アップグレード

最新バージョンにアップグレードするには、以下のコマンドを実行します。

go install github.com/mark3labs/memory-mcp-server-go@latest

貢献

• GitHub Issuesに問題を提出してください。
• 機能リクエストや修正を提出してください。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。

🔧 技術詳細

依存関係

• Go標準ライブラリ
• その他のカスタムパッケージ