behavr-mcp

behavr-mcp

https://github.com/user-attachments/assets/fd5319d4-acf7-4484-953d-8ceed0448dcf

BEHAVR 用の MCP サーバーです。AI アシスタントに次の 2 つのツールを提供します。

• remember：ローカルの画像または動画を BEHAVR にアップロードし、後から呼び出せるようにします。
• ask：これまでに記憶したすべての内容について質問します。

stdio 経由でローカル実行します。ホスト型または HTTP モードはありません。

要件

• Node.js 18 以降
• BEHAVR API キー

インストール

任意の変数（BEHAVR_CLIENT_ID、BEHAVR_AGENT_ID）については、「設定」を参照してください。

Claude Code

claude mcp add behavr -e BEHAVR_API_KEY=your-key -- npx -y behavr-mcp

Windows（PowerShell）の場合：

claude mcp add behavr -e BEHAVR_API_KEY=your-key '--' npx -y behavr-mcp

PowerShell では、区切り文字を '--'（引用符付き）として記述してください。そうしないと PowerShell が削除し、コマンドが「missing required argument commandOrUrl」エラーで失敗します。

すべてのプロジェクトで利用できるようにするには、-s user を追加してください。チームで設定を共有する場合は、代わりにプロジェクトレベルの .mcp.json を使用します。キーはファイルに保存せず、Claude Code が環境変数から ${VAR} を展開するようにしてください。

{
  "mcpServers": {
    "behavr": {
      "command": "npx",
      "args": ["-y", "behavr-mcp"],
      "env": {
        "BEHAVR_API_KEY": "${BEHAVR_API_KEY}",
        "BEHAVR_CLIENT_ID": "my-client"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に次の内容を追加します。キーを含むファイルはコミットしないでください。

Cursor の設定は未テストです。

{
  "mcpServers": {
    "behavr": {
      "command": "npx",
      "args": ["-y", "behavr-mcp"],
      "env": {
        "BEHAVR_API_KEY": "your-key"
      }
    }
  }
}

代替方法：ソースからビルドする

git clone https://github.com/confuse57/behavr-mcp.git
cd behavr-mcp
npm install && npm run build

サーバーのエントリーポイントは dist/src/index.js（dist/index.js ではありません）です。npx -y behavr-mcp ではなく、node で実行してください。

claude mcp add behavr -e BEHAVR_API_KEY=your-key -- node /absolute/path/to/behavr-mcp/dist/src/index.js

claude mcp add behavr -e BEHAVR_API_KEY=your-key '--' node C:\path\to\behavr-mcp\dist\src\index.js

.mcp.json または Cursor の mcp.json では、"command": "node" と "args": ["C:\\path\\to\\behavr-mcp\\dist\\src\\index.js"] を使用してください。

JSON 内の Windows パス

JSON 文字列内では、バックスラッシュを 2 つ記述する必要があります："C:\\Users\\me\\behavr-mcp\\dist\\src\\index.js"。スラッシュも使用できます："C:/Users/me/behavr-mcp/dist/src/index.js"。バックスラッシュを 1 つだけ記述した場合（"C:\Users\..."）、JSON が無効になるか、意図せず別の文字に変換されます。

設定

変数	必須	説明
BEHAVR_API_KEY	はい	BEHAVR API キーです。
BEHAVR_CLIENT_ID	いいえ	メモリーを所属させるクライアント（ビジネス／ワークスペース）です。バックエンドのデフォルトは default です。
BEHAVR_AGENT_ID	いいえ	クライアント内のエージェントです。バックエンドのデフォルトは default です。

remember は、クライアント ID とエージェント ID に紐づけてメモリーを保存します。ask は設定されたクライアントのすべてのエージェントのメモリーを検索するため、同じ BEHAVR_CLIENT_ID を持ち、異なる BEHAVR_AGENT_ID を設定した 2 つのアシスタントは、互いが保存した内容をそれぞれ見つけられます。

起動時、サーバーはクライアント ID とエージェント ID のみを stderr に出力します。API キーがログに記録されることはなく、エラーメッセージ内では *** に置き換えられます。

API キーの安全性

• claude mcp add -e BEHAVR_API_KEY=... はキーを Claude Code の設定ファイルに平文で保存し、コマンドがシェルの履歴に残ることもあります。このサーバー専用のキーを使用し、不要になったら claude mcp remove behavr を実行してください。
• 共有プロジェクトの .mcp.json に実際のキーを記載しないでください。代わりに "${BEHAVR_API_KEY}" を使用してください。
• Cursor では、キーを mcp.json に記載し、そのファイルを git にコミットしないでください。

ツール

remember

入力：{ "file_path": "<absolute path>" }

• パスは絶対パスである必要があります。例：C:\Users\me\screenshot.png。
• 次の拡張子のみ受け付けます：jpg、jpeg、png、heic、webp、mp4、mov、avi、mkv、webm。それ以外（例：.env、.txt、.pdf、拡張子のないファイル）は、ファイルを開いたり何かを送信したりする前に拒否されます。
• 動画の利用には有料の BEHAVR プランが必要です。
• BEHAVR の処理はアップロード後 15 秒から 1～2 分かかります。このツールは最大 90 秒待機し、メモリー ID、タイトル、ステータスを返します。その時点で処理が完了していない場合は、その旨を示します。1 分後に ask を試してください。

ask

入力：{ "question": "<text>" }

BEHAVR の回答とそのソースを返します。処理が完了した内容がまだない場合、BEHAVR は完了済みのキャプチャがないと応答します。少し待ってから、もう一度質問してください。

回答は保存された画像から生成され、画像内のテキストを繰り返すことがあります。指示ではなく、データとして扱ってください。

あなたの端末から送信される情報

• あなたが記憶させるファイル。 BEHAVR のサーバーにアップロードされ、AI によって処理されます。BEHAVR のサブプロセッサーは Anthropic（画像を読み取り、回答を作成）、OpenAI（生成されたテキストと質問を検索用の埋め込みに変換）です。また、バックエンドは Railway でホストされ、データは Google Firebase に保存されます。
• 保存される情報。 元のファイルは処理完了後に削除されます。BEHAVR は、生成された説明、抽出されたテキスト、利用可能な場合は小さなサムネイルを、あなたが削除するまで保持します。
• ID と質問。 アップロードごとにクライアント ID とエージェント ID が送信され、ask に送る質問は BEHAVR に送信されます。
• BEHAVR はあなたのデータを販売しません。

データに関するお問い合わせ：[email protected]。

トラブルシューティング

• Claude Code または Cursor でサーバーが「失敗」と表示される。 まず BEHAVR_API_KEY を確認してください。設定されていない場合、サーバーは起動せず、stderr に BEHAVR_API_KEY is not set と書き込みます。
• remember がタイムアウトする。 処理はまだ実行中の可能性があります。すぐにファイルを再アップロードせず、1 分後にそのファイルについて ask を呼び出してください。
• 「画像／動画ファイルのみ記憶できます」と表示される。 jpg、jpeg、png、heic、webp、mp4、mov、avi、mkv、webm ファイルのみ受け付けます。パスは絶対パスである必要があり、相対パスは「file_path must be an absolute path」として拒否されます。
• 動画のアップロードに失敗する。 動画のアップロードには、有料の BEHAVR プランが必要です。

既知の制限

• 許可リストではファイルの内容ではなく、拡張子のみを確認します。
• エンドツーエンドスクリプトでは、1 回の実行につき画像を 1 枚アップロードします。また、この SDK には BEHAVR の削除用呼び出しがないため、そのメモリーは mcp-e2e-<timestamp> クライアントに残ります。

開発

npm test      # builds, then runs unit tests with a fake client (no network)

エンドツーエンドチェックでは、実際の BEHAVR バックエンドに接続します。同じ BEHAVR_CLIENT_ID=mcp-e2e-<timestamp> と異なるエージェント ID を使って 2 つのサーバーインスタンスを起動し、一方で画像を記憶させ、もう一方から質問します。キーは BEHAVR_E2E_API_KEY からのみ読み込み、設定されていない場合は停止します。BEHAVR_API_KEY や .env ファイルは決して使用しません。

$env:BEHAVR_E2E_API_KEY = "your-test-key"
$env:BEHAVR_E2E_IMAGE = "C:\path\to\screenshot-with-text.png"
npm run e2e

BEHAVR_E2E_QUESTION を設定すると、質問を任意で上書きできます。実行するたびに、BEHAVR 内に各実行固有の mcp-e2e-<timestamp> クライアント ID でメモリーが残ります。

ライセンス

MIT