Repolode
投稿する
cosmicstack-labs

cosmicstack-labs/mercury-agent

ローカルメモリと権限で制御するツールを備え、CLI、Telegram、Discord、Slackから利用できるセルフホスト型AIエージェント。

GitHub で見る公式サイト
スター
3,881
フォーク
399
未解決の Issue
20
最終コミット
17 時間前

これは何？

Mercury Agentは、macOS、Linux、Windows、またはTermux経由のAndroidで動作する、TypeScript製のAIエージェントです。自分のマシン上で単一のバックグラウンドプロセスとして稼働します。ログイン時にサービスとして起動し、クラッシュ後は自動で再起動します。ターミナルUI、Telegram、Discord、Slack、Signal、または127.0.0.1にバインドされたローカルWebダッシュボードのどこからアクセスしても、同じエージェントとメモリを利用できます。

一般的なファイル、シェル、Webツールに加わるのが、操作を管理するための仕組みです。上書きできないシェルのブロックリスト、フォルダ単位の読み書き範囲、承認プロンプト、SSRF対策を施したフェッチ、ログ内のシークレットのマスキングを備えています。Second Brainは、型付けされ重複排除された事実をローカルのSQLiteデータベースに保存し、全文検索を使って回答の前に関連する情報を呼び出します。また、1日あたりのトークン予算によって各ターンの上限を設定できます。DeepSeek、OpenAI、Anthropic、Ollama、LM Studio、およびOpenAI互換エンドポイントを含む複数のプロバイダーを、フォールバック付きで試します。

中核機能を拡張するモードが2つあります。Mercury Codeはリポジトリ内で計画を立てて実装し、ビルド、テスト、または型チェックに合格した場合にのみタスク完了を報告します。Mercury Botsは、独自のペルソナ、権限、予算を持つ常駐型の専門エージェントです。スケジュールに沿って動作し、完成したファイルをローカルフォルダに保存します。約50種類の組み込みツールに加え、インストール可能なコミュニティスキルとcron形式のスケジューラーを備えています。

主な機能

  • 01固定のシェルブロックリスト、フォルダ単位の読み書き範囲、セッションごとの「Ask Me」または「Allow All」モード、SSRF対策済みのURLフェッチを備えた権限レイヤー。
  • 02Second Brainメモリ：10種類の事実を自動抽出してローカルのSQLiteデータベースに保存し、全文検索、1時間ごとの統合、`/memory`による確認に対応。
  • 03ターミナルUI、Telegram、Discord、Slack、Signal、チャット・カンバン・Bot操作画面を備えたlocalhostのWebダッシュボードから、1つのランタイムにアクセス可能。
  • 04Mercury Codeは実行中の計画を立てながらリポジトリ内で作業し、ビルド、テスト、または型チェックに合格した場合にのみタスクを完了扱いにします。
  • 05Mercury Botsは、単独またはタスクを委任するチームとして、ボットごとの予算とファイル成果物を備えた常駐型の専門エージェントとしてスケジュール実行されます。
  • 06DeepSeek、OpenAI、Anthropic、Grok、Ollama、LM Studio、およびOpenAI互換エンドポイントを対象としたプロバイダーのフォールバックに加え、1日あたりのトークン予算とToken Saverモードを備えています。
  • 07ファイル、シェル、git、GitHub、スケジュール管理、サブエージェント、Spotifyを扱う約50種類の組み込みツールと、skills.mercuryagent.shからインストールできるスキル。

ユースケース

  • ノートPCを閉じた後も動作を続け、メモリを保持するパーソナルアシスタントの運用。
  • 承認プロンプトと検証を経てから成功を報告するエージェントに、リポジトリ内のコード編集を任せる。
  • 管理者とメンバーでロールごとにアクセス権を分けながら、共有のTelegramまたはDiscordチャンネルから1つのエージェントを利用する。
  • 定期的な調査やレポート作成をスケジュールし、成果物をローカルフォルダまたはチャットに届ける。
  • プロンプト、キー、会話データをホスト型サービスではなく、自分のディスク上に保管する。

クイックスタート

  1. 1

    npm でインストール（Node.js 22 以降）

    npm i -g @cosmicstack/mercury-agent
  2. 2

    Mercury を実行し、セットアップウィザードを完了する

    mercury

使う前に知っておきたいこと

  • インストールスクリプトは Web からパイプされるため、1 行のインストーラーを使うには外部スクリプトを信頼する必要があります。
  • コミュニティ製のスキルは監査されていないため、インストール前に確認してください。
  • すべての機能を使うには、LLM プロバイダーの API キーまたは Mercury Cloud アカウントが必要です。

収録されている特集

オープンソースの AI エージェント・フレームワークとアプリセルフホスト型アプリCLI・ターミナルツール

トピック

#ai-agent#llm#self-hosted#cli#telegram#memory#permissions#scheduler#ai-assistant

よくある質問

mercury-agent とは？
ローカルメモリと権限で制御するツールを備え、CLI、Telegram、Discord、Slackから利用できるセルフホスト型AIエージェント。 Mercury Agentは、macOS、Linux、Windows、またはTermux経由のAndroidで動作する、TypeScript製のAIエージェントです。自分のマシン上で単一のバックグラウンドプロセスとして稼働します。ログイン時にサービスとして起動し、クラッシュ後は自動で再起動します。ターミナルUI、Telegram、Discord、Slack、Signal、または127.0.0.1にバインドされたローカルWebダッシュボードのどこからアクセスしても、同じエージェントとメモリを利用できます。
mercury-agent は無料で使えますか？ライセンスは？
mercury-agent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mercury-agent は今もメンテナンスされていますか？
活発にメンテナンス中。mercury-agent の最終コミットは 2026年11月6日 です。
mercury-agent は何に使えますか？
ノートPCを閉じた後も動作を続け、メモリを保持するパーソナルアシスタントの運用。 承認プロンプトと検証を経てから成功を報告するエージェントに、リポジトリ内のコード編集を任せる。 管理者とメンバーでロールごとにアクセス権を分けながら、共有のTelegramまたはDiscordチャンネルから1つのエージェントを利用する。 定期的な調査やレポート作成をスケジュールし、成果物をローカルフォルダまたはチャットに届ける。 プロンプト、キー、会話データをホスト型サービスではなく、自分のディスク上に保管する。
mercury-agent のインストール方法は？
npm でインストール（Node.js 22 以降）: npm i -g @cosmicstack/mercury-agent Mercury を実行し、セットアップウィザードを完了する: mercury
mercury-agent はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/cosmicstack-labs/mercury-agent

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト