{"_id":"@app-shot/appshot-mcp","_rev":"3-0c083eeb0c95cd783447f5710f40f15e","name":"@app-shot/appshot-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@app-shot/appshot-mcp","version":"1.0.0","keywords":["mcp","appshot","mobile","apk","ipa"],"author":"","license":"MIT","_id":"@app-shot/appshot-mcp@1.0.0","maintainers":[{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"}],"bin":{"appshot-mcp":"build/index.js"},"dist":{"shasum":"68f1bef4c86a775d2b43d7dfd649bf35991cd2f6","tarball":"https://registry.npmjs.org/@app-shot/appshot-mcp/-/appshot-mcp-1.0.0.tgz","fileCount":8,"integrity":"sha512-YIPZ0EnMnS84DNUOJ3gxSjInOm5hSHGA7sK7ys0zKKSJW2hsH01+K4hdKtPZ8nLsKTZ6o2jVHoU993J/AYo7KA==","signatures":[{"sig":"MEUCIDCfAe9knq6L/JmGVgXCCCagChnzWqCPLz9oIfa2nJw3AiEApdn4Rw7WwsKuRfoockmQIVzPiuLkGBWPM1G0KfnuyzM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":26276},"type":"module","gitHead":"14dd1cf7ff14bc49fb354934814abbd97a09c9cd","scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"},"_npmVersion":"11.6.2","description":"MCP server for appShot - Download mobile apps (APK/IPA)","directories":{},"_nodeVersion":"24.13.0","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/appshot-mcp_1.0.0_1773403705490_0.4755948070946485","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@app-shot/appshot-mcp","version":"1.0.1","keywords":["mcp","appshot","mobile","apk","ipa"],"author":"","license":"MIT","_id":"@app-shot/appshot-mcp@1.0.1","maintainers":[{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"}],"bin":{"appshot-mcp":"build/index.js"},"dist":{"shasum":"96c81adbacc491b8f8ae532e5d07c8140b62a571","tarball":"https://registry.npmjs.org/@app-shot/appshot-mcp/-/appshot-mcp-1.0.1.tgz","fileCount":9,"integrity":"sha512-QuhsOq+zzQB7BCEGMgeOzwZpJTV6NGcr1okssaXYzYxZNB3XiSmM8Tdvk9FZRVq1jcbwnmxZFBgLVpIWIW6K+Q==","signatures":[{"sig":"MEYCIQDZPW/1e0SOF5KUHSojAr1Su16oLQCwZrsRgOOupTgFIwIhAKZ6didiO/9nIAXnawBllCTopD3mFs8831d7rVabMcnX","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":28218},"type":"module","gitHead":"14dd1cf7ff14bc49fb354934814abbd97a09c9cd","scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build"},"_npmUser":{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"},"_npmVersion":"11.6.2","description":"MCP server for appShot - Download mobile apps (APK/IPA)","directories":{},"_nodeVersion":"24.13.0","dependencies":{"axios":"^1.7.9","@modelcontextprotocol/sdk":"^1.0.4"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.7.2","@types/node":"^22.10.2"},"_npmOperationalInternal":{"tmp":"tmp/appshot-mcp_1.0.1_1773403918970_0.35284660901265363","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@app-shot/appshot-mcp","version":"1.0.2","description":"MCP server for appShot - Download mobile apps (APK/IPA)","type":"module","bin":{"appshot-mcp":"build/index.js"},"scripts":{"build":"tsc","watch":"tsc --watch","prepare":"npm run build"},"keywords":["mcp","appshot","mobile","apk","ipa"],"author":"","license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.4","axios":"^1.7.9"},"devDependencies":{"@types/node":"^22.10.2","typescript":"^5.7.2"},"gitHead":"14dd1cf7ff14bc49fb354934814abbd97a09c9cd","_id":"@app-shot/appshot-mcp@1.0.2","_nodeVersion":"24.13.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-8VQYMgFIKOZ2gHWhmNWKc3wgRFJMhRFVxQ1ipfl0y8K3LqF73zvXoY9fRxrRn/aXDO4q2mAR3/50+M+VwTIBhQ==","shasum":"485edde84b30c4a531663af871e2e45410e5d9dc","tarball":"https://registry.npmjs.org/@app-shot/appshot-mcp/-/appshot-mcp-1.0.2.tgz","fileCount":8,"unpackedSize":29660,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIDrISfZ38MidTJNyM8PjI6c/HPhRfsk5S4/ILFH+AOYIAiEA+gnbzKMBWQrHO0Ws7OMdsaAojC+xH6kCxQFjej0H8ko="}]},"_npmUser":{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"},"directories":{},"maintainers":[{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/appshot-mcp_1.0.2_1773405041969_0.22949962563444237"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-13T12:08:25.382Z","modified":"2026-03-13T12:30:42.302Z","1.0.0":"2026-03-13T12:08:25.626Z","1.0.1":"2026-03-13T12:11:59.127Z","1.0.2":"2026-03-13T12:30:42.163Z"},"license":"MIT","keywords":["mcp","appshot","mobile","apk","ipa"],"description":"MCP server for appShot - Download mobile apps (APK/IPA)","maintainers":[{"name":"rxm_yuto","email":"yuto.uehara@mail.rooxim.com"}],"readme":"# appShot MCP Server\n\n[![npm version](https://img.shields.io/npm/v/@app-shot/appshot-mcp.svg)](https://www.npmjs.com/package/@app-shot/appshot-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nAn MCP (Model Context Protocol) server for [appShot](https://app-shot.com) — manage and download mobile apps (APK/IPA) from AI assistants.\n\n[日本語はこちら / Japanese](#appshot-mcp-server-日本語)\n\n## Tools\n\nThis MCP server provides the following tools:\n\n| Tool | Description |\n|------|-------------|\n| `list_groups` | List all groups the user belongs to |\n| `list_apps` | List all apps in a specific group |\n| `list_app_versions` | List all versions of a specific app |\n| `get_download_url` | Get the download URL for a specific app version (APK/IPA) |\n| `update_memo` | Update the private memo of an upload item |\n| `update_description` | Update the description of an upload item |\n| `list_tags` | List all tags in a group |\n| `list_app_tags` | List all tags for a specific app |\n| `update_tag` | Update a tag's name, color, or description |\n| `remove_tag_from_app` | Remove a tag from an app |\n\n## Installation\n\n```bash\nnpm install -g @app-shot/appshot-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `APPSHOT_TOKEN` | Yes | — | Authentication token (MCP token) |\n| `APPSHOT_API_URL` | No | `https://api.app-shot.com` | appShot API URL |\n\n### How to Get a Token\n\n1. Log in to [appShot](https://app-shot.com)\n2. Go to **Settings** > **MCP Token Management**\n3. Click **Create New Token**\n4. Set a token name (e.g., \"My MacBook\")\n5. Copy the generated token\n\n> **Important**: The token is only displayed once at creation. Store it in a safe place.\n\n### Claude Desktop\n\nAdd the following to your Claude Desktop configuration file:\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd with the CLI:\n\n```bash\nclaude mcp add appshot -- npx -y @app-shot/appshot-mcp\n```\n\nThen set the environment variable `APPSHOT_TOKEN` in your shell:\n\n```bash\nexport APPSHOT_TOKEN=\"your-mcp-token-here\"\n```\n\n### Cursor\n\nAdd the following to your Cursor MCP configuration file:\n\n- Project-level: `.cursor/mcp.json`\n- Global: `~/.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd the following to `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n## Usage Examples\n\nOnce configured, you can use natural language in your AI assistant:\n\n```\nList all groups I belong to\n```\n\n```\nShow me the apps in group \"xxx\"\n```\n\n```\nGet the download URL for app \"yyy\" version \"zzz\" in group \"xxx\"\n```\n\n## Development\n\n```bash\ngit clone <repository-url>\ncd mcp-server\nnpm install\nnpm run build\n```\n\n### Watch Mode\n\n```bash\nnpm run watch\n```\n\n## License\n\nMIT\n\n---\n\n# appShot MCP Server (日本語)\n\n[appShot](https://app-shot.com) 用の MCP（Model Context Protocol）サーバーです。AIアシスタントからモバイルアプリ（APK/IPA）の管理・ダウンロードが可能です。\n\n## ツール一覧\n\nこのMCPサーバーは以下のツールを提供します：\n\n| ツール | 説明 |\n|--------|------|\n| `list_groups` | ユーザーが所属するグループ一覧を取得 |\n| `list_apps` | グループ内のアプリ一覧を取得 |\n| `list_app_versions` | 特定のアプリのバージョン一覧を取得 |\n| `get_download_url` | 特定バージョンのアプリのダウンロードURL（APK/IPA）を取得 |\n| `update_memo` | アップロードアイテムのメモを更新 |\n| `update_description` | アップロードアイテムの説明を更新 |\n| `list_tags` | グループ内のタグ一覧を取得 |\n| `list_app_tags` | 特定アプリのタグ一覧を取得 |\n| `update_tag` | タグの名前・色・説明を更新 |\n| `remove_tag_from_app` | アプリからタグを削除 |\n\n## インストール\n\n```bash\nnpm install -g @app-shot/appshot-mcp\n```\n\n## 設定\n\n### 環境変数\n\n| 変数名 | 必須 | デフォルト値 | 説明 |\n|--------|------|-------------|------|\n| `APPSHOT_TOKEN` | はい | — | 認証トークン（MCPトークン） |\n| `APPSHOT_API_URL` | いいえ | `https://api.app-shot.com` | appShot APIのURL |\n\n### トークンの取得方法\n\n1. [appShot](https://app-shot.com) にログイン\n2. **設定** > **MCPトークン管理** に移動\n3. **新しいトークンを作成** をクリック\n4. トークン名を設定（例：「My MacBook」）\n5. 生成されたトークンをコピー\n\n> **重要**: トークンは作成時に一度だけ表示されます。必ず安全な場所に保管してください。\n\n### Claude Desktop での設定\n\nClaude Desktopの設定ファイルに以下を追加してください：\n\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code での設定\n\nCLIから以下のコマンドを実行してください：\n\n```bash\nclaude mcp add appshot -- npx -y @app-shot/appshot-mcp\n```\n\nシェルで環境変数 `APPSHOT_TOKEN` を設定してください：\n\n```bash\nexport APPSHOT_TOKEN=\"your-mcp-token-here\"\n```\n\n### Cursor での設定\n\nCursorのMCP設定ファイルに以下を追加してください：\n\n- プロジェクト単位: `.cursor/mcp.json`\n- グローバル: `~/.cursor/mcp.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n### Windsurf での設定\n\n`~/.codeium/windsurf/mcp_config.json` に以下を追加してください：\n\n```json\n{\n  \"mcpServers\": {\n    \"appshot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@app-shot/appshot-mcp\"],\n      \"env\": {\n        \"APPSHOT_TOKEN\": \"your-mcp-token-here\"\n      }\n    }\n  }\n}\n```\n\n## 使用例\n\n設定後、AIアシスタントで自然言語で操作できます：\n\n```\n私が所属しているグループの一覧を取得して\n```\n\n```\nグループ「xxx」のアプリ一覧を取得して\n```\n\n```\nグループ「xxx」のアプリ「yyy」のバージョン「zzz」のダウンロードURLを取得して\n```\n\n## 開発\n\n```bash\ngit clone <repository-url>\ncd mcp-server\nnpm install\nnpm run build\n```\n\n### ウォッチモード\n\n```bash\nnpm run watch\n```\n\n## ライセンス\n\nMIT\n","readmeFilename":"README.md"}