Elliot

Elliot

あらゆる API やデータベースを、Claude Code、Cursor、OpenClaw、Codex 用の MCP ツールに変換します。オブザーバビリティも組み込み済みです。

ドキュメント · クイックスタート · コンセプト · 5 つの原則

Elliot は、REST API、SQL データベース、ファイルなど、すでにお持ちの製品を、AI エージェントが うまく 利用できるツールに変換するオープンソースプラットフォームです。単に接続するだけでなく、高速で、安全で、オブザーバビリティを備えています。トークン使用量を最小限に抑え、エージェントが復旧できる構造化エラーを返し、すべてのエージェントセッションを完全に追跡できます。

対象となるユーザーは、すでに動作している API やデータベースを持ち、AI エージェントがそれらをネイティブに利用できるようにしたいプロダクトエンジニアです。トークン使用量を最小限に抑え、エラーから適切に復旧でき、完全なオブザーバビリティを備えた連携を実現できます。

AX はエージェントにとってのものであり、UX はユーザー、DX は開発者にとってのものです。Elliot の役割は、AX を測定可能にすることです。

目次

• Elliot を選ぶ理由
• 機能
• クイックスタート
• 動作を見る
• 仕組み
• コーディングエージェントを接続する
• プロジェクト構成
• ドキュメント
• ロードマップ
• コントリビューション
• コミュニティとサポート
• ライセンス

Elliot を選ぶ理由

API をエージェントに接続するのは簡単です。それを うまく 動作させるのは簡単ではありません。次のような場合、エージェントは失敗します。

• ツールの説明が曖昧 — エージェントが誤ったツールを選びます。
• 結果が大きすぎる — 回答を生成する前にコンテキストウィンドウが埋まります。
• エラーが構造化されていない — エージェントが復旧したり、上位にエスカレーションしたりできません。
• 何も可観測でない — ユーザーから苦情が来るまで、問題に気づけません。

Elliot はこれらの問題を可視化し、解決できるようにします。すべてのツールには、構造化スキーマ、トークン推定値、実行可能なエラー形式、セッショントレースが付属します。すべての呼び出しとエージェントについて、クライアントとモデルに紐付けて記録します。

機能

• エージェント対応を前提に設計 — すべてのツールは、リリース前に、動詞から始まる説明、型付きパラメーター、コンテキストに適したサイズの結果という、具体的な 5 つの原則に照らしてリントされます。
• デフォルトで安全 — パラメーター化 SQL、読み取り専用のデータベーストランザクション、環境変数によるシークレット管理を採用し、コネクターファイルにキーを含めません。コネクターファイルは安全にコミットできます。
• すべての呼び出しを可観測化 — すべてのエージェント呼び出しのトークン、レイテンシー、引数、エラーを監査ログにストリーミングし、Studio で確認できます。
• 起動は 1 コマンド — Docker でスタック全体を起動できます。Python、Node、ツールチェーンをインストールする必要はありません。
• あらゆるエージェントに対応 — Claude Code、Cursor、OpenClaw、Codex に対応しています。Elliot がそれぞれに自動登録します。
• エージェントがコネクターを構築 — 検出、構築、リント、評価、デプロイまで行えます。プラットフォーム自体がエージェント型であり、エージェントは Elliot を通じてコネクターを構築できます。

クイックスタート

Elliot を実行するだけですか？ 必要なのは Docker だけです。Python、Node、uv、pnpm は不要です。

curl -LsSf https://raw.githubusercontent.com/EliBarak12/Elliot/main/scripts/install.sh | sh

これにより、ビルド済みイメージを取得し、ローカルの .env を生成して、3 つのサービスをすべて起動し、Studio を http://localhost:8080 で開きます。docker compose -f docker-compose.run.yml down を実行すれば、いつでも停止できます。

Elliot を開発しますか？ 代わりにソースからビルドします。

# Prerequisites: uv (Python 3.13) and pnpm (Node 22)
git clone https://github.com/EliBarak12/Elliot.git && cd Elliot
make setup
make dev          # boots plugin (:3000) + studio (:5173)
                  # and writes the MCP config for every detected coding agent
                  # the runtime (:3001) starts on demand when you deploy a connector

次に、Studio を http://localhost:5173 で開き、コネクターをひな形から作成して lint を実行すれば、エージェントは同じセッション内でそれを利用できます。

実際の動作を見る

Elliot Studio のウォークスルーです。エージェントが構築するすべてのものを監視、実行、編集するビジュアルダッシュボードです。

上のループでは、Studio のすべてのページを順に表示します。高画質のスクリーンキャスト全編は、動画ウォークスルーをご覧ください。

Studio の詳細：

ツール — 動詞を先頭にした、型付きのコントラクトをエージェントが呼び出します。それぞれを設計、検証、テストできます。	メトリクス — すべてのツールにおける呼び出し回数、エラー率、レイテンシ、トークン効率です。
Agent Console — プロンプト、ツール呼び出し、トークン、エラーなど、すべてのエージェントセッションのライブトレースです。	ソース — REST API、PostgreSQL、MySQL、ファイルを一か所で検出、管理できます。

仕組み

1. Connect your data sources
   REST APIs, PostgreSQL, MySQL, CSV / JSON files — all in one connector

2. Build tools (no SQL required)
   Define name, description, parameters, filters, and return fields
   Elliot generates safe, parameterised queries
   Or let an agent build the connector for you with the agentic builder

3. Lint for agent-readiness
   elliot lint my-domain.connector.json

4. Write and run eval cases
   elliot eval my-domain.eval.yaml — pass/fail plus a token estimate

5. Deploy and connect agents
   plugin (:3000) serves tools to any MCP client
   runtime (:3001) executes them against live data
   studio observes, runs, and edits everything

6. (Optional) Ship the connector as a plugin
   elliot export-plugin my-domain.connector.json
   produces an installable Codex + Claude Code plugin folder

初回接続時、エージェントは自動的に prompts/get name=getting_started を呼び出します。この単一のプロンプトで、5 つの原則、標準的なワークフロー、利用可能なリファレンスリソースをエージェントに教えます。

コーディングエージェントを接続する

make dev は elliot connect を実行し、マシン上のすべてのコーディングエージェントを検出して、MCP 設定を自動的に書き込みます。クライアントを手動で接続する場合：

/plugin marketplace add EliBarak12/Elliot
/plugin install elliot@elliot

{ "mcpServers": { "elliot": {
  "url": "https://api.elliot-cloud.com/b/mcp"
}}}

codex plugin marketplace add EliBarak12/Elliot

openclaw plugins install elliot@elliot

どのインストール方法でも設定されるのは MCP URL のみです。Elliot のサーバーは、ローカルまたはホストされたエンドポイントで引き続き実行しておく必要があります。スキルはリポジトリルートの skills/ ディレクトリに含まれており、Claude Code と Codex は自動検出します。それ以外のすべての MCP クライアントには、MCP プロンプトとして同じガイダンスが提供されます。

Elliot を Claude.ai と Claude Desktop に追加する

上の表は、Claude Code プラグインについて説明しています。Claude.ai（ウェブ）または Claude Desktop / モバイルアプリで Elliot を使うには、リモートの コネクターとして追加します。Elliot のホストされたエンドポイントは MCP HTTP トランスポートに対応し、OAuth 2.1 のハンドシェイク全体を実行するため、貼り付けるキーはありません。

1. Claude で 設定 → コネクターを開きます。
2. カスタムコネクターを追加をクリックします。
3. Elliot MCP URL を貼り付けて確定します。

   https://api.elliot-cloud.com/b/mcp
   

4. Claude が自身を登録し（RFC 7591 動的クライアント登録）、Elliot の同意画面に移動します。サインインして 許可をクリックすると、Claude が接続済みの状態に戻ります。

Elliot のツールが、すべてのチャットでコネクター選択メニューに表示されるようになります。アクセス許可は Elliot ダッシュボードの 接続済みエージェントに表示され、いつでもそこで取り消せます。コネクターは各ユーザーを個別に認証するため（scope: per_user）、チームメンバーはそれぞれ自分の ID で認証します。共有シークレットは不要です。

Elliot をセルフホストしていますか？コネクターの接続先を、自身のデプロイ環境の /b/mcp URL に設定してください。OAuth ディスカバリードキュメントは同じホストから配信されるため、HTTPS で到達可能であれば問題ありません。

Anthropic の組み込み コネクターディレクトリに Elliot を掲載する方法（ユーザーが URL を貼り付けずに追加できるようにする方法）については、docs/claude-connector-directory.md を参照してください。

コネクターを独立したプラグインとして公開する

コネクターを構築したら、Codex と Claude Code にインストールできるスタンドアロンプラグインとしてパッケージ化できます。

elliot export-plugin my-domain.connector.json

これにより、Codex と Claude Code のマニフェスト、マーケットプレイス、コネクターを stdio 経由で提供する .mcp.json（elliot-mcp --connector）、および skills/ ディレクトリを含む my-domain-plugin/ フォルダーが生成されます。MCP サーバーの名前にはコネクターのスラッグが使われるため、ツール名は mcp__<slug>__<tool-id> になります。生成されるスキル（使い方ガイドと、コネクターの各ワークフローに対応するスキル）は、すでにこのプレフィックスを参照しています。/plugin marketplace add <folder>（Claude Code）または codex plugin marketplace add <folder>（Codex）でインストールしてください。

プロジェクト構成

Elliot は 4 つのパッケージからなるモノレポです。

コネクターファイルは connectors/ にあります。スターターテンプレートはプラグインに同梱されており（elliot://templates/ MCP リソースから参照できます）、すべての環境変数は .env.example に記載されています。

ドキュメント

詳細なドキュメントは elibarak12.github.io/Elliot にあります。

• クイックスタート — 数分でコネクターを起動
• 概念 — ソース、ツール、スキル、コネクター
• 5 つの原則 — すべてのコネクターが従う設計ルール
• コネクター仕様 — .connector.json スキーマの全容
• アーキテクチャ — 3 つのサービスの連携方法
• デプロイ — Docker イメージ、環境変数、ホスティング

ロードマップ

Elliot の目標は、開発者だけでなく、誰もが使えるようにすることです。進捗は dev/docs/USER_ONBOARDING.md で追跡しています。

コントリビューション

コード、コネクター、ドキュメント、バグ報告など、あらゆるコントリビューションを歓迎します。

• good first issuesを確認して、コントリビューションを始めましょう。
• 新しいコネクターは特に歓迎します。コネクターリクエストのテンプレートをご覧ください。
• PR を作成する前に、以下の必須チェックを実行してください。6 項目すべてに合格する必要があります。

uv run ruff check .
uv run ruff format --check .
uv run mypy packages/core/src packages/mcp-plugin/src packages/connector-runtime/src
uv run pytest --tb=short
pnpm --filter @elliot/studio run typecheck
pnpm --filter @elliot/studio test --run

コミュニティとサポート

バグを見つけた場合、機能をリクエストしたい場合、またはコネクターを提案したい場合は、issue トラッカーで issue を作成してください。すべての issue に目を通しています。

ライセンス

Elliot はMIT ライセンスのもとで公開されています。