Beemcp

🚀 BeeMCP 説明ドキュメント

BeeMCP は、Model Context Protocol (MCP) に基づくコンテキストマネージャです。AI アシスタントの機能強化を目的として設計されています。MCP プロトコルを通じて様々な LLM（大規模言語モデル）と統合し、会話履歴、ユーザーの事実、タスク、位置データの効率的な管理と検索を実現します。

🚀 クイックスタート

BeeMCP はコマンドラインツールを提供しており、ユーザーがすぐに使い始めることができます。

BeeMCP サービスの起動

bee-mcp start

BeeMCP 管理画面へのアクセス

起動後、ブラウザで http://localhost:3001 にアクセスすることで管理画面に入ることができます。

✨ 主な機能

BeeMCP は、データの管理と検索をサポートするための機能モジュールを提供します。

会話履歴管理

• すべての会話を表示：bee://conversations
• 特定の会話の詳細を取得：bee://conversations/{id}

ユーザー事実管理

• ユーザーの事実を記録：record-user-fact ツールを使用して新しい事実を作成します。
• 既存の事実を更新：update-user-fact ツールを使用して既存の事実を修正します。
• 指定された事実を削除：delete-user-fact ツールを使用して不要な事実を削除します。

タスク管理

• すべてのタスクを表示：bee://todos
• 未完了のタスクを取得：bee://todos/incomplete
• 特定のタスクの詳細を取得：bee://todos/{id}

位置データ管理

• 現在の位置を記録：record-location ツールを使用して、自動または手動で地理位置を記録します。
• 過去の位置を照会：
  • 過去 1 日の位置：bee://locations/today
  • 過去 1 週間の位置：bee://locations/week
  • 過去 1 か月の位置：bee://locations/month

📦 インストール

BeeMCP は、さまざまな開発環境のニーズに応えるため、複数のインストール方法を提供しています。

uv を使用したインストール

npm install bee-mcp -g

pip を使用したインストール（Python 環境向け）

pip install beemcp

💻 使用例

基本的な使用法

BeeMCP を使用したいくつかのサンプルクエリを次に示します。

- "昨日の会話記録は何ですか？"
- "John とのプロジェクトに関する会話内容を検索してください。"
- "私が黒コーヒーが好きだと覚えておいてください。（-> `record-user-fact`）"
- "実は、私はコーヒーにミルクを入れるのが好きです。（-> `update-user-fact`）"
- "私のタスクは何ですか？"
- "未完了のタスクリストを表示してください。"
- "「食料品を買う」をリマインダーに追加してください。"
- "「レポートを送信する」タスクを完了としてマークしてください。"
- "先週はどこに行きましたか？"
- "今日はどこに行きましたか？"

🔧 高度な機能

データの永続化

BeeMCP は、データをローカルストレージに永続化することをサポートしており、サービスの再起動後もデータが失われないようにします。

拡張プラグインシステム

ユーザーは必要に応じてカスタムプラグインを開発することができ、BeeMCP の機能を拡張することができます。プラグインは、npm または pip パッケージマネージャを通じてインストールおよびデプロイすることができます。

🔧 デバッグツール

開発者がデバッグを容易に行えるように、BeeMCP は MCP インスペクターツールを提供しています。

uvx を使用した実行

npx @modelcontextprotocol/inspector uvx beemcp

pip を使用したインストール

npx @model