{"_id":"@apps-in-toss/ax","_rev":"3-19c90ca3a1fc19b0a361c6ea39a8b406","name":"@apps-in-toss/ax","dist-tags":{"latest":"0.7.1"},"versions":{"0.7.1":{"name":"@apps-in-toss/ax","version":"0.7.1","keywords":["apps-in-toss","toss","mcp","mcp-server","mini-app","cli"],"author":{"name":"Viva Republica, Inc."},"license":"ISC","_id":"@apps-in-toss/ax@0.7.1","maintainers":[{"name":"apps-in-toss-bot","email":"hoseungb@toss.im"},{"name":"heecheol","email":"heecheol.kim@toss.im"},{"name":"ghlee","email":"dev.ghlee@gmail.com"},{"name":"gronxb","email":"gron1gh1@gmail.com"},{"name":"granite-bot","email":"ghlee@kakao.com"},{"name":"line0","email":"line0@toss.im"},{"name":"sunghyeonb.park","email":"sunghyeon.park@toss.im"},{"name":"gahyun.park","email":"gahyun.park@toss.im"},{"name":"wj-kang","email":"wj.kang@toss.im"},{"name":"hoseungme","email":"hsjang.dev@gmail.com"}],"homepage":"https://github.com/toss/apps-in-toss-ax#readme","bugs":{"url":"https://github.com/toss/apps-in-toss-ax/issues"},"os":["darwin","linux","win32"],"bin":{"ax":"bin/ax"},"cpu":["x64","arm64"],"dist":{"shasum":"b0c733e43cd00bffaacc6091eb0655f37646ae05","tarball":"https://registry.npmjs.org/@apps-in-toss/ax/-/ax-0.7.1.tgz","fileCount":3,"integrity":"sha512-gXYBoZ3dZo5uH4daImcnmmsbxwh3zWE7P+u2KqOcIvPM6n/FnRIXL1es+lUAAfq2kTqAJboAzSXpqC2EBELX9Q==","signatures":[{"sig":"MEQCIE4xNwg48sITDZMPmuvddjksazD/hOmqpkyV2ZkPHGlhAiA5GZz1ISv/96B7mfrq2vpjuWjD2h75sL60VRRG8LC1UA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":11217},"type":"module","engines":{"npm":">=8","node":">=22.9.0"},"gitHead":"e1b4989fc66612ee7a0427b944b106efe60383cd","scripts":{"prepack":"node -e \"require('fs').rmSync('bin', { recursive: true, force: true })\"","postinstall":"node scripts/postinstall.js"},"_npmUser":{"name":"apps-in-toss-bot","email":"hoseungb@toss.im"},"repository":{"url":"git+https://github.com/toss/apps-in-toss-ax.git","type":"git"},"_npmVersion":"11.16.0","description":"MCP server that provides AppsInToss documentation to AI assistants","directories":{},"_nodeVersion":"24.18.0","dependencies":{"tar":"7.5.16","bin-links":"^6.0.0","node-fetch":"^3.3.2","https-proxy-agent":"^7.0.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ax_0.7.1_1783501755868_0.3225322488447073","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2026-07-08T09:09:15.738Z","modified":"2026-08-04T01:14:06.072Z","0.7.1":"2026-07-08T09:09:16.017Z"},"bugs":{"url":"https://github.com/toss/apps-in-toss-ax/issues"},"author":{"name":"Viva Republica, Inc."},"license":"ISC","homepage":"https://github.com/toss/apps-in-toss-ax#readme","keywords":["apps-in-toss","toss","mcp","mcp-server","mini-app","cli"],"repository":{"url":"git+https://github.com/toss/apps-in-toss-ax.git","type":"git"},"description":"MCP server that provides AppsInToss documentation to AI assistants","maintainers":[{"email":"jingjing2@toss.im","name":"apps-in-toss-bot"}],"readme":"# AX (AppsInToss eXperience)\n\nAI 어시스턴트가 AppsInToss 미니앱 개발을 도울 수 있도록 설계된 MCP(Model Context Protocol) 서버입니다.\n\n## 주요 기능\n\nAX는 AI 어시스턴트에게 AppsInToss Developer Center의 문서를 제공하여, 토스 미니앱 개발에 대한 정확하고 컨텍스트 기반의 지원을 가능하게 합니다.\n\n### MCP Tools\n\n| 도구 | 설명 |\n|------|------|\n| `search_docs` | AppsInToss 문서 검색 |\n| `get_doc` | 검색 결과의 문서 전체 내용 조회 |\n| `search_tds_rn_docs` | TDS React Native 문서 검색 |\n| `get_tds_rn_doc` | TDS React Native 문서 전체 내용 조회 |\n| `search_tds_web_docs` | TDS Web 문서 검색 |\n| `get_tds_web_doc` | TDS Web 문서 전체 내용 조회 |\n\n### 지원 문서\n\n- **AppsInToss Developer Center** - 미니앱 개발 가이드\n- **TDS React Native** - 토스 디자인 시스템 (React Native)\n- **TDS Web** - 토스 디자인 시스템 (WebView)\n\n## 설치\n\n### Homebrew (macOS/Linux)\n\n```bash\nbrew tap toss/tap\nbrew install ax\n```\n\n### Scoop (Windows)\n\n```powershell\nscoop bucket add toss https://github.com/toss/scoop-bucket\nscoop install ax\n```\n\n### npm\n\n```bash\nnpm install -g @apps-in-toss/ax\n```\n\n## 사용법\n\n### MCP 서버 시작\n\n```bash\nax mcp\nax mcp --disable-usage-stats\n```\n\nAX는 제품 개선과 안정적인 운영을 위해 명령 실행, MCP 도구 호출, 성공 여부, 실행 시간 같은 사용 통계를 수집합니다.\n사용 통계 수집을 원하지 않으면 `--disable-usage-stats` 옵션을 추가하세요.\n\n### Cursor/Claude에서 사용\n\n[![Install MCP Server](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en-US/install-mcp?name=apps-in-toss&config=eyJjb21tYW5kIjoiYXgiLCJhcmdzIjpbIm1jcCJdfQ==)\n\n또는 `.cursor/mcp.json` / `claude_desktop_config.json`에 다음을 추가하세요:\n\n```json\n{\n  \"mcpServers\": {\n    \"apps-in-toss\": {\n      \"command\": \"ax\",\n      \"args\": [\n        \"mcp\"\n      ]\n    }\n  }\n}\n```\n\n## 프로젝트 구조\n\n```\napps-in-toss-ax/\n├── cmd/                    # CLI 명령어 정의\n├── internal/               # 내부 패키지\n│   ├── httputil/          # HTTP 유틸리티\n│   └── utils/             # 공통 유틸리티\n├── pkg/                    # 핵심 패키지\n│   ├── app/               # 애플리케이션 진입점\n│   ├── docs/              # 문서 관리\n│   ├── docid/             # 문서 ID 생성\n│   ├── features/          # 기능 구성\n│   ├── fetcher/           # HTTP 클라이언트\n│   ├── instrumentation/   # 사용 통계 수집\n│   ├── llms/              # llms.txt 파서\n│   ├── mcp/               # MCP 서버 구현\n│   └── search/            # 문서 검색 엔진\n├── tools/                  # 배포 도구\n│   ├── publish/           # 패키지 매니저 배포\n│   └── shared/            # 공유 유틸리티\n├── scripts/                # 스크립트\n├── main.go                # 메인 진입점\n├── go.mod                 # Go 모듈 정의\n├── Makefile               # 빌드 명령어\n└── package.json           # npm 패키지 정의\n```\n\n## 개발\n\n### 빌드\n\n```bash\nmake build\n# 또는\ngo build -o ax\n```\n\n### 테스트\n\n```bash\ngo test ./...\n```\n\n### 로컬 실행\n\n```bash\n./ax mcp\n```\n\n## AppsInToss란?\n\n**AppsInToss**는 토스 앱 내에서 미니앱을 제공할 수 있는 플랫폼입니다. 3,000만 토스 사용자에게 서비스를 노출하고, SDK와 API를 활용해 빠르게 개발할 수 있습니다.\n\n### 주요 개념\n\n| 용어 | 설명 |\n|------|------|\n| **Granite** | 미니앱 개발 프레임워크 (구 Bedrock, v1.0+) |\n| **TDS** | Toss Design System - 비게임 미니앱 필수 |\n\n### 개발 방식\n\n- **React Native**: 네이티브에 가까운 성능\n- **WebView**: 웹 기술 활용\n\n## 관련 링크\n\n- [AppsInToss Developer Center](https://developers-apps-in-toss.toss.im)\n- [TDS React Native](https://tossmini-docs.toss.im/tds-react-native)\n- [TDS Web](https://tossmini-docs.toss.im/tds-mobile)\n","readmeFilename":"README.md"}