Skip to content

Commit c388038

Browse files
ochafikclaude
andcommitted
docs: add Kotlin example to main README and Mac setup instructions
- Add link to basic-host-kotlin in top-level README examples section - Add collapsible Mac installation instructions for Android SDK/emulator - Fix stale ext-apps2 references to ext-apps 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent 544b3be commit c388038

File tree

2 files changed

+29
-3
lines changed

2 files changed

+29
-3
lines changed

README.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,8 @@ Start with these foundational examples to learn the SDK:
4949

5050
- [`examples/basic-server-vanillajs`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-vanillajs) — Example MCP server with tools that return UI Apps (vanilla JS)
5151
- [`examples/basic-server-react`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-server-react) — Example MCP server with tools that return UI Apps (React)
52-
- [`examples/basic-host`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host) — Bare-bones example of hosting MCP Apps
52+
- [`examples/basic-host`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host) — Bare-bones example of hosting MCP Apps (TypeScript/React)
53+
- [`examples/basic-host-kotlin`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host-kotlin) — Android example of hosting MCP Apps (Kotlin/Jetpack Compose)
5354

5455
The [`examples/`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples) directory contains additional demo apps showcasing real-world use cases.
5556

examples/basic-host-kotlin/README.md

Lines changed: 27 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -58,14 +58,39 @@ examples/basic-host-kotlin/
5858
- **Android SDK**: API 26+ (Android 8.0+)
5959
- **MCP Server**: A running MCP server with UI resources
6060

61+
<details>
62+
<summary>Installing Android SDK and emulator on Mac</summary>
63+
64+
```bash
65+
brew install --cask android-commandlinetools
66+
67+
# Accept licenses
68+
yes | sdkmanager --licenses
69+
70+
# Install required components
71+
sdkmanager "platform-tools" "emulator" "platforms;android-34" "system-images;android-34;google_apis;arm64-v8a"
72+
73+
# Create an AVD (Android Virtual Device)
74+
avdmanager create avd -n Pixel_8 -k "system-images;android-34;google_apis;arm64-v8a" -d pixel_8
75+
76+
# Add to PATH (add to ~/.zshrc)
77+
export ANDROID_HOME=/opt/homebrew/share/android-commandlinetools
78+
export PATH=$ANDROID_HOME/emulator:$ANDROID_HOME/platform-tools:$PATH
79+
80+
# Start emulator
81+
emulator -avd Pixel_8
82+
```
83+
84+
</details>
85+
6186
## Setup Instructions
6287

6388
### 1. Open Project
6489

6590
Open Android Studio and select "Open an Existing Project". Navigate to this directory:
6691

6792
```
68-
/path/to/ext-apps2/examples/basic-host-kotlin
93+
/path/to/ext-apps/examples/basic-host-kotlin
6994
```
7095

7196
### 2. Sync Gradle
@@ -89,7 +114,7 @@ You need a running MCP server with UI resources. For testing, you can use the QR
89114

90115
```bash
91116
# In a terminal, navigate to the examples directory
92-
cd /path/to/ext-apps2/examples/qr-code
117+
cd /path/to/ext-apps/examples/qr-code
93118

94119
# Install dependencies
95120
npm install

0 commit comments

Comments
 (0)