aai-gateway - GitLite

KO | EN

gitlite — search

#hacktoberfest #react #typescript #llm #golang #machine-learning #deep-learning #java #awesome #cli #kubernetes #vue #pytorch #mcp

aai-gateway

(★ 98)

AAI Gateway — Install MCP servers and skills once, share across all your AI agents. One-time setup, 90% less context overhead. The unified gateway for AI agent tooling.

파일 탐색기

최종 버전 다운로드 (.zip)

- architecture.md
- architecture.png
- - app-registry.ts
  - execution-coordinator.ts
  - gateway.ts
  - guide-service.ts
  - import-service.ts
  - importer.ts
  - index.ts
  - parsers.ts
  - search-guidance.ts
  - seed.ts
  - tool-definitions.ts
- - checks.ts
  - index.ts
- - errors.ts
- - acp-tool-schemas.ts
  - acp.ts
  - events.ts
  - interface.ts
  - mcp.ts
  - skill.ts
- - app-guide-generator.ts
- - server.ts
- - schema.ts
- - agent-state.ts
  - cache.ts
  - generation.ts
  - index.ts
  - managed-registry.ts
  - mcp-registry.ts
  - paths.ts
  - registry.ts
  - skill-registry.ts
- - aai-json.ts
  - caller.ts
  - capabilities.ts
  - executor.ts
  - index.ts
  - storage.ts
- - config.ts
  - dotenv.ts
  - ids.ts
  - locale.ts
  - logger.ts
  - schema-validator.ts
- acp-and-schema.test.ts
- cli.ts
- index.ts
- version.ts
- vite-env.d.ts
.gitignore
.prettierrc
CLAUDE.md
CONTRIBUTING.md
eslint.config.mjs
LICENSE
package-lock.json
package.json
README.ja.md
README.ko.md
README.md
README.zh-CN.md
tsconfig.json
vite.config.ts
vitest.config.ts

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/gybob/aai-gateway

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd aai-gateway

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

[English](README.md) | [简体中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md)

---

# AAI Gateway: Unified MCP & Skill Management, Shared Across AI Agents, 99% Context Token Savings

[![npm version](https://img.shields.io/npm/v/aai-gateway)](https://www.npmjs.com/package/aai-gateway)
[![license](https://img.shields.io/npm/l/aai-gateway)](https://raw.githubusercontent.com/gybob/aai-gateway/main/LICENSE)

---

## What Is It

**AAI** = **Agent App Interface**

AAI Gateway is the interaction gateway for Agent Apps.

What is an **Agent App**? An Agent App is a collection of capabilities that an Agent can use. For example:

- An **MCP Server** is an Agent App — it provides a set of tools
- A **Skill package** is an Agent App — it provides one or more skills

In AAI Gateway, they are abstracted as **Agent Apps** under unified management. Import once, and all AI Agents can use them immediately.

---

## What Problems Does It Solve

### Context Bloat

Traditional: 10 MCPs × 5 tools = **50 full schemas ≈ 7,500 tokens** injected into every conversation.

AAI Gateway: each Agent App needs only **fewer than 50 tokens for a summary**, with details loaded on demand. **99% token savings.**

### Finding Tools Is Hard

Traditional: search GitHub → read READMEs → copy JSON configs → debug connections → restart Agent.

AAI Gateway: **tell your Agent "use AAI to search for xxx" — auto-searches, installs, ready to use**.

> "Use AAI to search for a browser automation tool"
>
> → Search → finds Playwright MCP → Agent summarizes a one-line Agent App summary → install → ready to use, no restart needed

> "Use AAI to search for a PPT creation skill"
>
> → Search → finds PPT Skill → uses skill description as Agent App summary → install → ready to use, no restart needed

### Duplicate Config

Configure the same thing in Claude Code, Codex, and OpenCode separately? Import once through AAI Gateway, all Agents share instantly.

---

## Quick Start (30 Seconds)

**Claude Code:**

```bash
claude mcp add --scope user --transport stdio aai-gateway -- npx -y aai-gateway
```

**Codex:**

```bash
codex mcp add aai-gateway -- npx -y aai-gateway
```

**OpenCode** — add to `~/.config/opencode/opencode.json`:

```json
{
  "mcp": {
    "aai-gateway": {
      "type": "local",
      "command": ["npx", "-y", "aai-gateway"],
      "enabled": true
    }
  }
}
```

**[OpenClaw](https://openclaw.ai):**

```bash
openclaw plugins install openclaw-aai-gateway-plugin
```

Once installed, just tell your Agent what you want to do.

---

## Built-in Tools

| Tool | Description |
|------|-------------|
| `search:discover` | Search and install new tools with natural language |
| `mcp:import` | Import an MCP Server as an Agent App |
| `skill:import` | Import a Skill package as an Agent App |
| `listAllAaiApps` | List all registered Agent Apps |
| `enableApp` / `disableApp` | Enable or disable an Agent App per Agent |
| `removeApp` | Remove an Agent App |
| `aai:exec` | Execute a specific tool within an Agent App |

Each imported Agent App generates an **`app_<app-id>`** tool that returns the full operation guide and tool list when called.

### Preset Agent Apps (auto-discovered when locally installed)

| App ID | Name | Description |
|--------|------|-------------|
| `claude` | Claude Code | AI coding assistant for code editing, analysis, and development |
| `codex` | Codex | OpenAI-powered AI coding assistant |
| `opencode` | OpenCode | AI development assistant for editing files and running commands |

---

## Architecture

![Architecture](https://raw.githubusercontent.com/gybob/aai-gateway/main/images/architecture.png)

---

## Developers: Get Your Agent App Auto-Discovered

Create an `aai.json` descriptor and submit it to `src/discovery/descriptors/`. When a user's local environment meets the `discovery.checks` conditions, the Agent will auto-discover your Agent App.

```json
{
  "schemaVersion": "2.0",
  "version": "1.0.0",
  "app": {
    "name": { "default": "My App" }
  },
  "discovery": {
    "checks": [
      { "kind": "command", "command": "my-app" }
    ]
  },
  "access": {
    "protocol": "mcp",
    "config": {
      "command": "my-app-mcp",
      "args": ["--stdio"]
    }
  },
  "exposure": {
    "summary": "Use when the user wants to do X."
  }
}
```

`discovery.checks` supports three check types: `command` (command exists), `file` (file exists), `path` (directory exists).

Supported protocols: `mcp`, `skill`, `acp-agent`

Welcome to [submit a PR](../../pulls) to contribute new Agent App descriptors, or [open an issue](../../issues) for feedback.