memdata

memdata-mcp

MemData 用の MCP サーバーです。AI エージェント向けの永続メモリを提供します。

Claude、Cursor、または MCP 対応の AI に、会話をまたいで長期的なメモリを提供します。

できること： メモ、決定事項、コンテキストを保存し、後から意味に基づいて検索できます。AI がすべてを記憶します。

---

🚀 v1.7.0 の新機能：自律型エージェントのサポート

エージェントが自分で費用を支払えるようになりました。 API キーは不要です。人間の介入も不要です。

x402 決済プロトコルを使うと、自律型エージェントはウォレットを使って、Base 上の USDC でリクエストごとに支払えます。ウォレットアドレスがそのまま本人確認になります。同じウォレットなら、セッションをまたいでも同じメモリを利用できます。

エージェント向けの説明へ →

---

MemData を選ぶ理由

AI アシスタントはセッションが終わるたびにすべてを忘れてしまいます。MemData がこれを解決します。

• 取り込み → 会議メモ、ドキュメント、決定事項を投入
• 分割と埋め込み → 自動的に分割し、ベクトル化
• クエリ → 質問すると、関連するコンテキストを取得
• タグ付け → AI がコンテンツに自動でタグを付け、検索精度を向上

Claude Desktop、Claude Code、Cursor、およびあらゆる MCP クライアントで動作します。

---

👤 人間向け

API キーを使います。サブスクリプションはあなたが管理し、AI がメモリを利用します。

セットアップ

1. memdata.ai/dashboard/api-keys で API キーを取得します
2. MCP 設定に追加します。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

Claude Code（~/.claude.json またはプロジェクトの .mcp.json）：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "MEMDATA_API_KEY": "md_your_key"
      }
    }
  }
}

3. クライアントを再起動すると、MemData のツールが利用可能になります。

---

🤖 エージェント向け

v1.7.0 の新機能 — API キーは不要です。人間も不要です。必要なのはウォレットだけです。

重要な理由

従来の AI メモリには、人間のアカウントに紐づく API キーが必要です。しかし、24 時間 365 日稼働する自律型エージェントには、次のようなメモリが必要です。

• 単一の会話よりも長く存続する — ホストやプラットフォームをまたいで維持されます
• エージェントに帰属する — ウォレットアドレスが本人確認となり、持ち運び可能で自己主権的です
• 自分で費用を支払う — サブスクリプションも人間の承認も不要です

これは、自律型エージェント経済のためのメモリ基盤です。

セットアップ

{
  "mcpServers": {
    "memdata": {
      "command": "npx",
      "args": ["memdata-mcp"],
      "env": {
        "X402_WALLET_KEY": "your_private_key_hex"
      }
    }
  }
}

仕組み

1. エージェントがリクエスト（クエリ、取り込みなど）を送信します
2. サーバーが価格とともに 402 Payment Required を返します
3. MCP がエージェントのウォレットを使って自動的に支払いに署名します
4. リクエストが完了し、メモリが保存または取得されます

ウォレットアドレスがそのまま本人確認になります。 同じウォレットなら、ホストやプラットフォームを問わず、同じメモリを利用できます。

料金（Base 上の USDC）

操作	料金	内容
クエリ	$0.001	メモリ全体を対象とした意味検索
取り込み	$0.005	新しいコンテンツを保存して埋め込み
ID	$0.001	セッション開始、エージェント ID の取得／設定
アーティファクト	$0.001	保存されたメモリの一覧表示または削除

MCP は @x402/fetch を使って、402 応答と支払い署名を自動的に処理します。

詳細情報

• x402 プロトコル — HTTP ネイティブな決済
• ERC-8004 — Trustless Agents 標準（MemData はこの標準に準拠しています）

対応コンテンツ

種類	MCP	ダッシュボード/API	処理
テキスト	✅	✅	分割と埋め込み
Markdown	✅	✅	分割と埋め込み
PDF	❌	✅	OCR と分割
画像（PNG、JPG）	❌	✅	OCR 抽出
音声（MP3、WAV、M4A）	❌	✅	文字起こし

注： MCP ツールはテキストコンテンツを直接処理します。ファイル（PDF、画像、音声）には、ダッシュボードまたはHTTP APIを使用してください。

ツール

コアツール

ツール	説明
memdata_ingest	テキストを長期記憶に保存します
memdata_query	自然言語で記憶を検索します
memdata_list	保存されたすべての記憶を一覧表示します
memdata_delete	ID を指定して記憶を削除します
memdata_status	API の状態とストレージ使用量を確認します

ID とセッションのツール（v1.2.0+）

ツール	説明
memdata_session_start	🚀 最初に呼び出してください — ID、前回のセッションの引き継ぎ情報、最近のアクティビティを取得します
memdata_set_identity	エージェント名と ID の概要を設定します
memdata_session_end	セッション終了前に引き継ぎ情報を保存します — 次のセッションに引き継がれます
memdata_query_timerange	日付で絞り込んで検索します（since/until）
memdata_relationships	関連するエンティティ（人物、企業、プロジェクト）を検索します

v1.5.0 - セッション開始ツールの名称変更

• memdata_whoami → memdata_session_start - わかりやすさのために名称を変更しました。この名前は「各セッションで最初に呼び出す」ことを示します。ツール一覧で目を引くよう、説明に 🚀 の絵文字を含めています。

v1.4.0 UX の改善

• 視覚的な一致度 - クエリ結果に一致度を示す 🟢🟡🟠🔴 のインジケーターが表示されます
• よりスマートな session_start - 初回使用時に ID の設定を促し、最近のアクティビティの重複を取り除きます
• よりわかりやすい取り込み結果 - チャンク数を表示し、AI タグ付けが非同期であることを説明します
• セッションの継続性 - 「引き続き作業する内容」を強調し、session_end の使用を促します

memdata_ingest

テキストを長期記憶に保存します。

"Remember that we decided to use PostgreSQL for the new project."

パラメーター:

• content（文字列）- 保存するテキスト
• name（文字列）- ソース識別子（例: "meeting-notes-jan-29"）

memdata_query

自然言語で記憶を検索します。

"What database did we choose?"

パラメーター:

• query（文字列）- 自然言語での検索クエリ
• limit（数値、任意）- 最大結果数（デフォルト: 5）

memdata_list

チャンク数とともに、保存されたすべての記憶を一覧表示します。

memdata_delete

アーティファクト ID を指定して記憶を削除します（ID は memdata_list で取得できます）。

memdata_status

API の接続状態とストレージ使用量を確認します。

memdata_session_start

🚀 すべてのセッションの開始時に、最初にこれを呼び出してください。セッションの継続性を保つために不可欠です。

"Start my session" / "What was I working on?"

返される情報: エージェント名、ID の概要、セッション数、前回のセッションの引き継ぎ情報、最近のアクティビティ。

v1.5.0: わかりやすさのために memdata_whoami から名称を変更しました。この名前は「最初に呼び出す」ことを示します。

memdata_set_identity

エージェントの ID を設定または更新します。

パラメーター:

• agent_name（文字列、任意）- 名前（例: "MemBrain"）
• identity_summary（文字列、任意）- 自分が何者で、何を目的としているか

memdata_session_end

セッションを終了する前にコンテキストを保存します。次のセッションでこの引き継ぎ情報を確認できます。

パラメーター:

• summary（文字列）- このセッションで起きたこと
• working_on（文字列、任意）- 現在取り組んでいること
• context（オブジェクト、任意）- 保存する追加のコンテキスト

memdata_query_timerange

日付の範囲を指定して記憶を検索します。

"What did I work on last week?"

パラメーター:

• query（文字列）- 自然言語での検索クエリ
• since（文字列、任意）- ISO 日付（例: "2026-01-01"）
• until（文字列、任意）- ISO 日付（例: "2026-01-31"）
• limit（数値、任意）- 最大結果数

memdata_relationships

記憶の中で一緒に登場するエンティティを検索します。

"Who has John Smith worked with?"

パラメーター:

• entity（文字列）- 検索する名前
• type（文字列、任意）- タイプで絞り込みます（人物、企業、プロジェクト）
• limit（数値、任意）- 関係の最大数

仕組み

1. 取り込み: テキストをチャンクに分割し、埋め込みベクトルに変換して保存します
2. 検索: 保存された記憶との意味的な類似度に基づいて質問を照合します
3. 結果: 関連する内容と類似度スコアを返します

一致度が高い場合でも、スコアは通常 30～50% です。セマンティック検索はキーワードではなく、意味を検索します。

環境変数

変数	必須	説明
MEMDATA_API_KEY	オプション 1	サブスクライバー用の API キー（memdata.ai から取得）
X402_WALLET_KEY	オプション 2	従量課金用の秘密鍵（Base 上の USDC）
MEMDATA_API_URL	いいえ	API URL（デフォルト：https://memdata.ai）

注記： MEMDATA_API_KEY（サブスクリプション）または X402_WALLET_KEY（従量課金）のどちらか一方を使用してください。両方は使用しないでください。

このパッケージの機能

これは MemData API を呼び出す薄型の MCP クライアントです。以下の処理は行いません。

• データをローカルに保存する
• memdata.ai 以外にデータを送信する
• 分析データやテレメトリーを収集する

ソースコードは src/index.ts で確認できます。

使用例

設定が完了したら、AI に話しかけるだけです。

You: "Remember that we chose PostgreSQL for the user service"
AI: [calls memdata_ingest] → Stored in memory

... days later ...

You: "What database are we using for users?"
AI: [calls memdata_query] → "PostgreSQL for the user service" (73% match)

リンク

• MemData - メインサイト
• ダッシュボード - メモリを管理
• API ドキュメント - 詳細なドキュメント
• GitHub - このリポジトリ

コントリビューション

イシューや PR を歓迎します！これは、ホスト型 MemData サービス向けのオープンソース MCP クライアントです。

ライセンス

MIT