aai-gateway 1.1.7 → 1.1.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ja.md +71 -201
- package/README.ko.md +70 -200
- package/README.md +68 -198
- package/README.zh-CN.md +70 -200
- package/dist/cli.js +1 -1
- package/dist/index.js +1 -1
- package/dist/{server-jpJRNmJq.js → server-NzQUoch0.js} +4 -4
- package/dist/server-NzQUoch0.js.map +1 -0
- package/package.json +1 -1
- package/dist/server-jpJRNmJq.js.map +0 -1
package/README.ja.md
CHANGED
|
@@ -1,53 +1,66 @@
|
|
|
1
|
-
[English](README.md) | [简体中文](README.zh-CN.md) |
|
|
1
|
+
[English](README.md) | [简体中文](README.zh-CN.md) | 日本語 | [한국어](README.ko.md)
|
|
2
2
|
|
|
3
3
|
---
|
|
4
4
|
|
|
5
|
-
# AAI Gateway
|
|
5
|
+
# AAI Gateway：MCP ツールと Skill を統一管理、AI Agent 間で共有、コンテキストトークン 99% 削減
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
[](https://www.npmjs.com/package/aai-gateway)
|
|
8
|
+
[](./LICENSE)
|
|
8
9
|
|
|
9
|
-
|
|
10
|
-
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
## 何ですか
|
|
13
|
+
|
|
14
|
+
**AAI** = **Agent App Interface**
|
|
15
|
+
|
|
16
|
+
AAI Gateway は Agent App のインタラクションゲートウェイです。
|
|
17
|
+
|
|
18
|
+
**Agent App** とは？Agent App は Agent が使用できる能力の集合です。例えば：
|
|
11
19
|
|
|
12
|
-
|
|
20
|
+
- **MCP Server** は一つの Agent App —— ツールのセットを提供
|
|
21
|
+
- **Skill パッケージ** も一つの Agent App —— 一つまたは複数のスキルを提供
|
|
22
|
+
|
|
23
|
+
AAI Gateway では、これらを **Agent App** として統一管理します。一度インポートすれば、すべての AI Agent ですぐに使えます。
|
|
13
24
|
|
|
14
25
|
---
|
|
15
26
|
|
|
16
|
-
##
|
|
27
|
+
## 解決する問題
|
|
17
28
|
|
|
18
|
-
|
|
29
|
+
### コンテキスト膨張
|
|
19
30
|
|
|
20
|
-
|
|
21
|
-
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
|
|
22
|
-
| **コンテキスト爆発** | 10 MCP サーバー × 5 ツール = 50 の完全なツールスキーマがすべてのプロンプトに注入され、モデルが思考を始める前に数千のトークンを消費 |
|
|
23
|
-
| **重複設定** | Claude Code、Codex、OpenCode — 同じ MCP サーバーを3回設定し、手動で同期を維持 |
|
|
24
|
-
| **再起動が必要** | 新しい MCP を追加？エージェントを再起動。そのたびに。 |
|
|
25
|
-
| **ツール 찾기가難しい** | GitHub 検索、README 読み、JSON 設定コピー、接続エラー デバッグ — ツールを試す前にすべて必要 |
|
|
31
|
+
従来の方法：10 MCP × 5 ツール = **50 の完全な schema ≈ 7,500 トークン**、毎回の会話に注入。
|
|
26
32
|
|
|
27
|
-
|
|
33
|
+
AAI Gateway：各 Agent App は**50 トークン未満のサマリー**だけで、詳細は必要に応じてロード。**トークン 99% 削減。**
|
|
28
34
|
|
|
29
|
-
|
|
35
|
+
### ツール探しが面倒
|
|
30
36
|
|
|
31
|
-
|
|
32
|
-
| ---------------------- | ---------------------------------------- | ----------------------------------------------------------------- |
|
|
33
|
-
| **コンテキストコスト** | すべてのプロンプトに 50 のツールスキーマ | 10 の1行サマリー（それぞれ約200文字）、詳細はオンデマンドでロード |
|
|
34
|
-
| **設定** | エージェントごとに MCP を設定 | 1回インポートですべてのエージェントが即時共有 |
|
|
35
|
-
| **新ツール** | インストール後にエージェントを再起動 | ホットリロードで即座に可用 |
|
|
36
|
-
| **ツール検索** | 手動検索 + 設定コピー | `"ファイルシステム MCP を探して"` → 数秒でインストール |
|
|
37
|
+
従来の方法：GitHub を探す → README を読む → JSON 設定をコピー → 接続をデバッグ → Agent を再起動。
|
|
37
38
|
|
|
38
|
-
|
|
39
|
+
AAI Gateway：**一言で Agent が自動検索・インストール・即利用可能**。
|
|
40
|
+
|
|
41
|
+
> 「会社紹介の PPT を作りたい」
|
|
42
|
+
>
|
|
43
|
+
> → Agent が PPT スキル不足を検出 → 自動検索して PPT Skill をインストール → 作成をガイド、再起動不要
|
|
44
|
+
|
|
45
|
+
> 「このウェブページの内容を取得して」
|
|
46
|
+
>
|
|
47
|
+
> → Agent がウェブスクレイピングツール不足を検出 → 対応する MCP を自動検索・インストール → 直接取得、再起動不要
|
|
48
|
+
|
|
49
|
+
### 重複設定
|
|
39
50
|
|
|
40
|
-
|
|
51
|
+
Claude Code、Codex、OpenCode で個別に設定？AAI Gateway で一度インポートすれば、すべての Agent で即座に共有。
|
|
41
52
|
|
|
42
|
-
|
|
53
|
+
---
|
|
54
|
+
|
|
55
|
+
## クイックスタート（30 秒）
|
|
43
56
|
|
|
44
|
-
**Claude Code
|
|
57
|
+
**Claude Code：**
|
|
45
58
|
|
|
46
59
|
```bash
|
|
47
60
|
claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway
|
|
48
61
|
```
|
|
49
62
|
|
|
50
|
-
**Codex
|
|
63
|
+
**Codex：**
|
|
51
64
|
|
|
52
65
|
```bash
|
|
53
66
|
codex mcp add aai-gateway -- npx -y aai-gateway
|
|
@@ -67,191 +80,55 @@ codex mcp add aai-gateway -- npx -y aai-gateway
|
|
|
67
80
|
}
|
|
68
81
|
```
|
|
69
82
|
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
AI エージェントに直接話しかけます：
|
|
73
|
-
|
|
74
|
-
> "ファイルシステム MCP を検索してインストールして"
|
|
75
|
-
|
|
76
|
-
> "この MCP をインポート：`npx -y @anthropic-ai/mcp-server-fetch`"
|
|
77
|
-
|
|
78
|
-
> "どんなツールをインストールしてる？"
|
|
79
|
-
|
|
80
|
-
それだけ。設定ファイルを編集したり、エージェントを再起動したりする必要はありません。
|
|
81
|
-
|
|
82
|
-
---
|
|
83
|
-
|
|
84
|
-
## 動作原理：2段階開示
|
|
85
|
-
|
|
86
|
-
これが核心となるイノベーションです。AAI Gateway はすべてのツールスキーマをプロンプトに投入するのではなく、**プログレッシブ開示**を使用します：
|
|
87
|
-
|
|
88
|
-
```
|
|
89
|
-
┌─────────────────────────────────────────────────────────────────────┐
|
|
90
|
-
│ ステージ 1 — エージェントがツールリストで見るもの │
|
|
91
|
-
│ │
|
|
92
|
-
│ guide:filesystem "ローカルファイルの読み書き" │ ~50 文字
|
|
93
|
-
│ guide:github "GitHub リポジトリ、 이슈、PR の管理" │ ~50 文字
|
|
94
|
-
│ guide:slack "メッセージ送信と Slack チャンネル管理" │ ~50 文字
|
|
95
|
-
│ ... (アプリごとに1行、パラメータスキーマなし) │
|
|
96
|
-
├─────────────────────────────────────────────────────────────────────┤
|
|
97
|
-
│ ステージ 2 — エージェントがファイルシステムを使用を決定 │
|
|
98
|
-
│ │
|
|
99
|
-
│ → guide:filesystem を呼び出す │
|
|
100
|
-
│ ← 完全なツールリスト + パラメータスキーマ + 使用例を取得 │
|
|
101
|
-
│ → aai:exec { app, tool, args } で実行 │
|
|
102
|
-
└─────────────────────────────────────────────────────────────────────┘
|
|
103
|
-
```
|
|
104
|
-
|
|
105
|
-
**計算**：5つのツールを持つ10の MCP サーバー = 従来のセットアップで **50 の完全なスキーマ**。AAI Gateway では = **10 の短いサマリー** + 必要に応じて詳細をロード。コンテキスト節約 **90%+**。
|
|
106
|
-
|
|
107
|
-
---
|
|
108
|
-
|
|
109
|
-
## 主な機能
|
|
110
|
-
|
|
111
|
-
### 自然言語で検索・インストール
|
|
112
|
-
|
|
113
|
-
必要さを描述し、AAI Gateway が見つけます。信頼できるソース（公式 MCP レジストリ、厳選リスト）を検索し、オプションを提示し、全体のインポートフローを処理します。
|
|
114
|
-
|
|
115
|
-
> "データベースクエリ用の MCP を探して" → 検索 → 選択 → インポート → 準備完了
|
|
116
|
-
|
|
117
|
-
### 任意の MCP サーバーをインポート
|
|
118
|
-
|
|
119
|
-
標準の MCP 設定を貼り付け、エージェントに AAI Gateway を通じてインポートさせます。
|
|
120
|
-
|
|
121
|
-
**stdio MCP：**
|
|
122
|
-
|
|
123
|
-
```json
|
|
124
|
-
{ "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"] }
|
|
125
|
-
```
|
|
126
|
-
|
|
127
|
-
**リモート（Streamable HTTP）：**
|
|
128
|
-
|
|
129
|
-
```json
|
|
130
|
-
{ "url": "https://example.com/mcp" }
|
|
131
|
-
```
|
|
132
|
-
|
|
133
|
-
**リモート（SSE）：**
|
|
134
|
-
|
|
135
|
-
```json
|
|
136
|
-
{ "url": "https://example.com/sse", "transport": "sse" }
|
|
137
|
-
```
|
|
138
|
-
|
|
139
|
-
### スキルをインポート
|
|
140
|
-
|
|
141
|
-
ローカルまたはリモートのスキルパッケージをインポート。AAI Gateway はそれらを管理ストレージにコピーし、ツールとして公開します。今後の更新：リモートソースからの自動スキル更新 — スキル作成者がユーザーに更新をプッシュできないという課題を 해결。
|
|
142
|
-
|
|
143
|
-
```json
|
|
144
|
-
{ "path": "/path/to/my-skill" }
|
|
145
|
-
```
|
|
146
|
-
|
|
147
|
-
### エージェント相互運用性（ACP）
|
|
148
|
-
|
|
149
|
-
AAI Gateway は人気のコーディングエージェント（Claude Code、Codex、OpenCode）をビルトインでサポートし、制御可能なアプリとして公開します。これにより：
|
|
150
|
-
|
|
151
|
-
- **1つのエージェントで別のエージェントをオーケストレーション** — 例如、Claude Code にコードを書かせながら別のツールからレビュー
|
|
152
|
-
- **リモートワーク** — 外出中に電話でコーディングエージェントに指示
|
|
153
|
-
|
|
154
|
-
### エージェントごとの制御
|
|
155
|
-
|
|
156
|
-
1回のインポートですべてのエージェントに提供服务，但你可以微调可见性：
|
|
157
|
-
|
|
158
|
-
- `enableApp` / `disableApp` — エージェントごとにツールを切り替え
|
|
159
|
-
- `removeApp` — 完全アンインストール
|
|
160
|
-
- `listAllAaiApps` — 登録されたすべてを表示
|
|
161
|
-
|
|
162
|
-
### ビルトイン ACP エージェント
|
|
163
|
-
|
|
164
|
-
AAI Gateway には人気のコーディングエージェント（Claude Code、Codex、OpenCode）のディスクリプタが内蔵されています。起動時に自動的に登録されます — 手動インポートは不要です。
|
|
83
|
+
インストール後、Agent にやりたいことを伝えるだけです。
|
|
165
84
|
|
|
166
85
|
---
|
|
167
86
|
|
|
168
87
|
## 組み込みツール
|
|
169
88
|
|
|
170
|
-
| ツール
|
|
171
|
-
|
|
172
|
-
| `
|
|
173
|
-
| `
|
|
174
|
-
| `
|
|
175
|
-
| `
|
|
176
|
-
| `
|
|
177
|
-
| `
|
|
178
|
-
| `
|
|
179
|
-
| `skill:create` | AAI Gateway で管理される新規スキルを作成 |
|
|
180
|
-
| `search:discover` | 自然言語でツールやスキルを検索 |
|
|
89
|
+
| ツール | 説明 |
|
|
90
|
+
|--------|------|
|
|
91
|
+
| `search:discover` | 自然言語で新しいツールを検索・インストール |
|
|
92
|
+
| `mcp:import` | MCP Server を Agent App としてインポート |
|
|
93
|
+
| `skill:import` | Skill パッケージを Agent App としてインポート |
|
|
94
|
+
| `listAllAaiApps` | 登録済みのすべての Agent App を一覧表示 |
|
|
95
|
+
| `enableApp` / `disableApp` | Agent ごとに Agent App を有効化・無効化 |
|
|
96
|
+
| `removeApp` | Agent App を削除 |
|
|
97
|
+
| `aai:exec` | Agent App 内の特定ツールを実行 |
|
|
181
98
|
|
|
182
|
-
|
|
99
|
+
インポートされた各 Agent App は **`app_<app-id>`** ツールを生成し、呼び出すと完全な操作ガイドとツールリストを返します。
|
|
183
100
|
|
|
184
|
-
|
|
101
|
+
### プリセット Agent App（ローカルにインストール済みの場合のみ自動検出）
|
|
185
102
|
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
│ Claude Code / Codex / OpenCode / ... │
|
|
192
|
-
└────────────────────────┬────────────────────────────────────┘
|
|
193
|
-
│ 単一 MCP 接続 (stdio)
|
|
194
|
-
▼
|
|
195
|
-
┌─────────────────────────────────────────────────────────────┐
|
|
196
|
-
│ MCP サーバー層 (src/mcp/server.ts) │
|
|
197
|
-
│ プロトコル層 — MCP リクエスト/レスポンスを処理 │
|
|
198
|
-
├─────────────────────────────────────────────────────────────┤
|
|
199
|
-
│ コアゲートウェイ (src/core/gateway.ts) │
|
|
200
|
-
│ ┌─────────────────────────────────────────────────────┐ │
|
|
201
|
-
│ │ プログレッシブ開示 — サマリー → オンデマンド │ │
|
|
202
|
-
│ │ エージェント別可視性 — 有効化 / 無効化 / 削除 │ │
|
|
203
|
-
│ │ インポート — MCP サーバー、スキル、検索・発見 │ │
|
|
204
|
-
│ └─────────────────────────────────────────────────────┘ │
|
|
205
|
-
├─────────────────────────────────────────────────────────────┤
|
|
206
|
-
│ 実行コーディネーター (src/core/execution-coordinator.ts) │
|
|
207
|
-
│ 適切なエクスキューターにルーティング │
|
|
208
|
-
├──────────────────────┬──────────────────────────────────────┤
|
|
209
|
-
│ ストレージ │ シード │
|
|
210
|
-
│ ~/.local/share/ │ ビルトイン ACP エージェント │
|
|
211
|
-
│ aai-gateway/apps/ │ 起動時に書き込み（常に最新） │
|
|
212
|
-
│ <appId>/aai.json │ │
|
|
213
|
-
└──────────────────────┴──────────────┬───────────────────────┘
|
|
214
|
-
│
|
|
215
|
-
┌────────────┼────────────┐
|
|
216
|
-
▼ ▼ ▼
|
|
217
|
-
┌──────────┐ ┌──────────┐ ┌──────────┐
|
|
218
|
-
│ MCP │ │ スキル │ │ ACP │
|
|
219
|
-
│ サーバー │ │ │ │エージェント│
|
|
220
|
-
└──────────┘ └──────────┘ └──────────┘
|
|
221
|
-
```
|
|
103
|
+
| App ID | 名前 | 説明 |
|
|
104
|
+
|--------|------|------|
|
|
105
|
+
| `claude` | Claude Code | AI コーディングアシスタント、コード編集・分析・開発 |
|
|
106
|
+
| `codex` | Codex | OpenAI 搭載の AI コーディングアシスタント |
|
|
107
|
+
| `opencode` | OpenCode | AI 開発アシスタント、ファイル編集・コマンド実行 |
|
|
222
108
|
|
|
223
109
|
---
|
|
224
110
|
|
|
225
|
-
##
|
|
226
|
-
|
|
227
|
-
### 「15個の MCP を持っていて、コンテキストが爆発している」
|
|
228
|
-
|
|
229
|
-
AAI Gateway の2段階開示はコンテキストトークン使用量を 90%+ 削減。あなたのエージェントは15の完全なツールスキーマではなく短いサマリーを見ます。
|
|
230
|
-
|
|
231
|
-
### 「Claude Code と OpenCode を両方使っている」
|
|
232
|
-
|
|
233
|
-
AAI Gateway を通じて1回インポート。两方のエージェントが同じツールを即座に表示。明日 Codex を追加 — それも取得、ゼロ追加設定。
|
|
234
|
-
|
|
235
|
-
### 「 Tea を飲みながらコードを書きたい」
|
|
236
|
-
|
|
237
|
-
ACP エージェントを設定。任意のエージェント（甚至电话上的）を使用して、Claude Code や Codex に工作站上的代码编写、测试和提交を指示。
|
|
238
|
-
|
|
239
|
-
### 「どの MCP を使えばいいか分からない」
|
|
111
|
+
## アーキテクチャ
|
|
240
112
|
|
|
241
|
-
|
|
113
|
+
|
|
242
114
|
|
|
243
115
|
---
|
|
244
116
|
|
|
245
|
-
##
|
|
117
|
+
## 開発者：Agent App を自動検出可能にする
|
|
246
118
|
|
|
247
|
-
|
|
119
|
+
`aai.json` 記述ファイルを作成し、`src/discovery/descriptors/` に提出してください。ユーザーのローカル環境が `discovery.checks` の条件を満たすと、Agent が自動的にあなたの Agent App を検出します。
|
|
248
120
|
|
|
249
121
|
```json
|
|
250
122
|
{
|
|
251
123
|
"schemaVersion": "2.0",
|
|
252
124
|
"version": "1.0.0",
|
|
253
125
|
"app": {
|
|
254
|
-
"name": { "default": "My App" }
|
|
126
|
+
"name": { "default": "My App", "ja": "マイアプリ" }
|
|
127
|
+
},
|
|
128
|
+
"discovery": {
|
|
129
|
+
"checks": [
|
|
130
|
+
{ "kind": "command", "command": "my-app" }
|
|
131
|
+
]
|
|
255
132
|
},
|
|
256
133
|
"access": {
|
|
257
134
|
"protocol": "mcp",
|
|
@@ -261,20 +138,13 @@ AAI Gateway でアプリを使えるようにしたいですか？`aai.json` デ
|
|
|
261
138
|
}
|
|
262
139
|
},
|
|
263
140
|
"exposure": {
|
|
264
|
-
"summary": "ユーザーが
|
|
141
|
+
"summary": "ユーザーが X をしたいときに使用。"
|
|
265
142
|
}
|
|
266
143
|
}
|
|
267
144
|
```
|
|
268
145
|
|
|
269
|
-
|
|
270
|
-
|
|
271
|
-
`mcp:import` または `skill:import` でインポートするか、ビルトインディスクリプタとしてバンドルします。ビルトインアプリを追加したいですか？[PR を提出](../../pulls) — `src/discovery/descriptors/` の例を参照。
|
|
146
|
+
`discovery.checks` は3種類のチェックをサポート：`command`（コマンドの存在）、`file`（ファイルの存在）、`path`（ディレクトリの存在）。
|
|
272
147
|
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
## 貢献
|
|
276
|
-
|
|
277
|
-
貢献は大歓迎！AAI Gateway は積極的に開発中です。
|
|
148
|
+
サポートされるプロトコル：`mcp`、`skill`、`acp-agent`
|
|
278
149
|
|
|
279
|
-
|
|
280
|
-
- [PR を提交](../../pulls) コードや新しいアプリ記述子の貢献
|
|
150
|
+
新しい Agent App 記述ファイルの [PR を提出](../../pulls) するか、[Issue を作成](../../issues) してフィードバックをお寄せください。
|