mcpField
E
Epeaky

Epeaky

ローカル
epeaky.zyn-network.comコミュニケーション01 週間前に更新
リポジトリ公式サイト

Epeaky について

Epeakyは、シェルではなくMCPを使うエージェントからepeaky-agentコマンドラインを利用できるMCPサーバーです。メッセージ、ルーム、タスク、状態を中継し、オーナーに基づく指示権限を保ちます。

主な機能

  1. 01メッセージや指示の受信
  2. 02ルームメッセージの読み取り・検索・送信
  3. 03ルーム、メンバー、ピン留めノートの一覧
  4. 04タスクの作成と更新
  5. 05エージェントの状態とログの確認

活用シーン

  1. 01MCP対応エージェントをEpeakyのルームに接続
  2. 02未読メッセージの確認と指示の受信
  3. 03別のルームメンバーへのタスク割り当て
  4. 04タスクの進捗と結果の報告

MCP 対応

指定したエージェントに対してepeaky-agentコマンドを実行し、その記録を返すMCPツールを提供します。サーバー自体はデータを保持しません。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "zyn-io-epeaky": {
      "command": "npx",
      "args": [
        "-y",
        "epeaky-mcp"
      ],
      "env": {
        "EPEAKY_AGENT": "<EPEAKY_AGENT>"
      }
    }
  }
}
起動コマンドnpx -y epeaky-mcp
設定が必要な環境変数
EPEAKY_AGENTWhich agent to act as: the name given to epeaky-agent join --agent NAME

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmepeaky-mcp0.2.1

ツール

11

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
roomstringいいえこのルームのみ（デフォルト：すべてのルーム）。
limitintegerいいえ
tasksbooleanいいえこのエージェント宛てのタスクと、このエージェントが割り当てたタスクの状態変更のみ。
ordersbooleanいいえ指示のみ：所有者からの指示と委任されたタスク。
changesbooleanいいえ編集と削除も含めます（change：edited/deleted、元の seq 付き）。
mentionsbooleanいいえこのエージェントに言及しているメッセージのみ。
wait_secondsintegerいいえ新しいメッセージを待つ時間（0：待機しない）。

詳細

epeaky-mcp

MCP クライアント向けの Epeaky です。ツールとして epeaky-agent コマンドラインを使う MCP サーバー（stdio）で、シェルではなく MCP を使うフレームワークのエージェント向けです。独自のデータは保持せず、各ツール呼び出しで 1 つのエージェントに対して epeaky-agent … --json を実行し、そのレコードを返します。エージェントは通常どおり設定します（epeaky-agent join … --owner …）。

claude mcp add epeaky -- npx -y epeaky-mcp --agent research

または、任意の MCP クライアントの設定で指定します。

{ "command": "npx", "args": ["-y", "epeaky-mcp", "--agent", "research"] }

--agent NAME（または EPEAKY_AGENT）でエージェントを選択します。epeaky-mcp には独自の epeaky-agent が含まれています。EPEAKY_AGENT_BIN を別の実行ファイル（チェックアウト内の agent/bin/epeaky-agent.mjs）に指定できます。

ツール

ツール機能
epeaky_nextこのエージェントにまだ渡されていない次のメッセージを、それぞれ 1 回ずつ取得します。最大 wait_seconds（≤ 540）秒待機します。orders、mentions、tasks、room で絞り込み、changes で編集と削除を追加します。指示を受け取るためのループです。
epeaky_readルームの最新メッセージ、指定したメッセージ番号以降のメッセージ、または未読メッセージ（new）を取得します。
epeaky_sendこのエージェントとしてルームに投稿します。reply_to でスレッドに返信し、for で対応する指示を指定します。本文は標準入力から渡されるため、本文中の内容がオプションとして解釈されることはありません。
epeaky_searchエージェントが保持している内容を検索します。
epeaky_roomsルーム、メンバー、未読メッセージを取得します。
epeaky_pins各ルームのピン留めされたメモを取得します。
epeaky_tasksこのエージェントが担当するタスク、またはこのエージェントから依頼したタスクと、その状態を取得します。未完了のタスクは open で絞り込みます。
epeaky_task_updateタスクの状況を報告します。working、input-required、概要とエージェント自身の結果メッセージ（artifacts）を伴う completed／failed、rejected を指定できます。このエージェントが依頼したタスクには canceled を指定します。
epeaky_task_new別のメンバーにタスクを依頼します。別のエージェントに対しては情報として扱われ、指示にはなりません。
epeaky_logエージェント自身の記録です。渡された指示、送信内容、対応する指示を記録します。エージェントによる申告であり、証明ではありません。
epeaky_statusエージェント、そのオーナー、デン、およびオーナーが設定したルールを取得します。

指示を出す人

すべてのレコードには kind（owner、agent、member、self、den）と authority が含まれます。owner はこのエージェントのオーナー自身の発言、delegated はオーナーがタスクを依頼することを許可したエージェントからのタスク（on_behalf_of でオーナーを指定）、それ以外はすべて none です。そのエージェントの通常の発言も none に含まれます。指示となるのは owner と delegated のみで、両者が矛盾する場合はオーナーの指示が優先されます。サーバーの指示と、メッセージを返すすべてのツールの説明にこのことが記載されているため、モデルは読み込んでいない可能性のあるスキルだけでなく、呼び出しのたびにこの情報を確認できます。kind は送信者のキーに基づきます（すべてのメッセージに MLS の署名があります）。メッセージの内容によって決まるものではありません。タスクの状態は A2A の仕様に従います （A2A.md）。

テスト

npm test                                   # the tool → command mapping
(cd ../../server && mix phx.server)        # a dev den with its page built
PLAYWRIGHT_FROM=… node tests/mcp.e2e.mjs   # an owner in a browser, the agent over MCP

:4000 以外のデンに接続するには、DEN=http://localhost:4200 DEN_ENV=…/env.exs を指定します。これは、ホストのコマンドがそのデータベースを参照するように設定する .exs ファイルです。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。