RhysSullivan/executor
요약
Executor는 AI 에이전트들이 공유할 수 있는 통합 도구 계층을 제공하는 CLI 및 런타임입니다. 이 시스템은 OpenAPI, GraphQL 등 다양한 표준에 대한 지원을 통해 여러 에이전트(Cursor, Claude Code 등)가 공통의 도구 카탈로그, 인증 및 정책을 공유하도록 합니다. 사용자는 웹 UI나 CLI를 통해 소스를 추가하고, 타입 지정된 TypeScript 런타임을 사용하여 의도 기반으로 도구를 발견하고 호출할 수 있습니다.
핵심 포인트
- AI 에이전트들을 위한 통합 도구 계층(Integration Layer) 역할을 수행합니다.
- OpenAPI, GraphQL, MCP 등 다양한 표준을 지원하여 여러 에이전트 간의 도구 및 인증 공유를 가능하게 합니다.
- 웹 UI와 CLI 명령어를 통해 소스를 쉽게 추가하고 관리할 수 있으며, 타입 지정된 런타임을 제공합니다.
- 개발자는 `executor web` 또는 `executor daemon run` 명령어로 로컬 런타임/데몬을 시작하여 에이전트가 접근할 수 있도록 합니다.
wsC2ArbOLkAKcPU6.mp4
AI 에이전트를 위한 통합 계층입니다. 사용하는 모든 에이전트에서 공유되는 모든 도구의 카탈로그를 제공합니다.
npm install -g executor
executor web
이렇게 하면 http://127.0.0.1:4788에서 웹 UI가 있는 로컬 런타임이 시작됩니다.
여기서 첫 번째 소스를 추가하고 도구 사용을 시작하세요.
MCP와 호환되는 모든 에이전트(Cursor, Claude Code, OpenCode 등)를 Executor에 연결하여 모든 에이전트에서 도구 카탈로그, 인증 및 정책을 공유할 수 있습니다.
executor mcp
예시 mcp.json
Claude Code / Cursor용:
{
"mcpServers": {
"executor": {
...
JSON 스키마로 표현할 수 있다면, 그것이 통합(integration)이 될 수 있습니다. Executor는 OpenAPI, GraphQL, MCP 및 Google Discovery에 대한 퍼스트파티 지원을 제공하지만, 플러그인 시스템은 모든 소스 유형에 열려 있습니다.
http://127.0.0.1:4788에서 열고 Add Source로 이동한 후 URL을 붙여넣으면 Executor가 유형을 감지하고 도구를 인덱싱하며 인증까지 처리합니다.
executor call executor openapi addSource '{
"spec": "https://petstore3.swagger.io/api/v3/openapi.json",
"namespace": "petstore",
...
OpenAPI 문서에 상대 경로 servers 항목(예: "/api/v3")이 있는 경우 baseUrl을 사용하세요.
에이전트는 타입 지정된 TypeScript 런타임을 통해 도구를 발견하고 호출합니다:
// 의도(intent)로 검색
const matches = await tools.discover({ query: "github issues", limit: 5 });
// 스키마 검사
...
CLI를 통해 도구 사용하기:
executor tools search "send email"
executor call --help
executor call github --help
...
executor call
, executor resume
, 그리고 executor tools ...
명령어들은 필요한 경우 로컬 데몬을 자동 시작합니다.
기본 포트가 사용 중인 경우, CLI는 사용 가능한 로컬 포트를 선택하고 자동으로 추적합니다.
실행이 인증(auth)이나 승인을 위해 일시 중지된 경우, 이를 재개합니다:
executor resume --execution-id exec_123
executor web # 런타임 + 웹 UI 시작
executor daemon run # 백그라운드에서 영구 로컬 데몬 시작
executor daemon status # 데몬 상태 표시
...
bun install
bun dev
개발 서버는 http://127.0.0.1:4788에서 시작됩니다.
.
Discord 참여하기: https://discord.gg/eF29HBHwM6
더 자세한 내용은 executor.sh를 방문하세요.
- npm 패키지 이름
executor를 제공해 준 Crystian에게 감사드립니다.
제 코딩 과정의 일환으로, 저는 패턴과 다른 사람들이 시스템을 구현한 방식을 이해하기 위해 다른 코드베이스에 대한 참조(references)에 에이전트가 접근할 수 있도록 합니다.
참조 목록은 다음과 같습니다 (포괄적이지 않음):
- Better Auth - Storage adapter reference
- Effect - General code patterns
- OpenCode - Plugin system reference
- OpenClaw - Plugin system reference
- Emdash - Plugin system reference
- Pi - Plugin system reference
이 코드베이스를 참조하여 어떻게 구현되었는지 이해하는 데 사용하시는 것도 권장합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending TypeScript (weekly)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기