Skip to content

feat: Add Kotlin SDK for MCP Apps #134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
ochafik wants to merge 16 commits into
base: main
Choose a base branch
from
Draft

feat: Add Kotlin SDK for MCP Apps #134

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
16 commits
Select commit Hold shift + click to select a range
8af725b
feat: Add Kotlin SDK for MCP Apps
ochafik Dec 11, 2025
3eebaa9
feat: Add Kotlin SDK for MCP Apps
ochafik Dec 11, 2025
66fc58c
feat: Add Kotlin SDK for MCP Apps
ochafik Dec 11, 2025
7dc8540
Merge branch 'ochafik/kotlin-sdk' of https://github.com/modelcontextp…
ochafik Dec 11, 2025
cb70420
Merge main into kotlin-sdk
ochafik Dec 11, 2025
f03d1c6
Merge branch 'ochafik/kotlin-sdk' of https://github.com/modelcontextp…
ochafik Dec 11, 2025
143af83
Merge remote-tracking branch 'origin/main' into ochafik/kotlin-sdk
ochafik Dec 11, 2025
adf2c68
feat(kotlin-host): implement graceful teardown pattern
ochafik Dec 11, 2025
a4bfaa6
chore: Remove Swift SDK example and type generation
ochafik Dec 11, 2025
dbe05e7
chore: Remove non-existent Swift SDK job from CI
ochafik Dec 11, 2025
544b3be
test(kotlin-host): add protocol handler unit tests and test infrastru…
ochafik Dec 11, 2025
c388038
docs: add Kotlin example to main README and Mac setup instructions
ochafik Dec 11, 2025
114f2bc
Merge branch 'ochafik/kotlin-sdk' of https://github.com/modelcontextp…
ochafik Dec 11, 2025
80cf7d9
fix(kotlin-host): handle size-changed notification to resize WebView
ochafik Dec 11, 2025
fc87ef5
fix(kotlin-host): reduce teardown timeout from 3s to 500ms with polling
ochafik Dec 11, 2025
e873118
feat(kotlin-sdk): add timeout parameter to sendResourceTeardown
ochafik Dec 11, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 21 additions & 0 deletions .github/workflows/ci.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,24 @@
- run: npm test

- run: npm run prettier

kotlin:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4

- name: Set up JDK 21
uses: actions/setup-java@v4
with:
java-version: "21"
distribution: "temurin"

- name: Build Kotlin SDK
working-directory: kotlin
run: |
chmod +x gradlew
./gradlew build

- name: Test Kotlin SDK
working-directory: kotlin
run: ./gradlew test
Comment on lines +41 to +59

Check warning

Code scanning / CodeQL

Workflow does not contain permissions Medium

Actions job or workflow does not limit the permissions of the GITHUB_TOKEN. Consider setting an explicit permissions block, using the following as a minimal starting point: {contents: read}

Copilot Autofix

AI 3 days ago

The best fix is to explicitly add a permissions block at the root level of the workflow file .github/workflows/ci.yml. This will apply the specified minimal permissions to all jobs (unless any override them individually). As recommended, setting contents: read is the least privilege needed for typical CI build/test workflows. No other changes are required unless future workflow steps are added that require additional permissions.

To implement this, insert the following YAML section directly after the name: CI line (so it applies globally):

permissions:
  contents: read

This ensures the workflow restricts GitHub token permissions to only those required for read access to repository contents.

Suggested changeset 1
.github/workflows/ci.yml

Autofix patch

Autofix patch
Run the following command in your local git repository to apply this patch
cat << 'EOF' | git apply
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,6 @@
 name: CI
+permissions:
+  contents: read
 
 on:
   push:
EOF
@@ -1,4 +1,6 @@
name: CI
permissions:
contents: read

on:
push:
Copilot is powered by AI and may make mistakes. Always verify output.
10 changes: 10 additions & 0 deletions .prettierignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,3 +4,13 @@ examples/basic-server-react/**/*.ts
examples/basic-server-react/**/*.tsx
examples/basic-server-vanillajs/**/*.ts
examples/basic-server-vanillajs/**/*.tsx

# Swift package manager build artifacts
sdk/swift/.build/
examples/basic-host-swift/.build/
examples/basic-host-swift/build/
examples/basic-host-kotlin/.gradle/
examples/basic-host-kotlin/build/

# Swift build artifacts
swift/.build/
3 changes: 2 additions & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,8 @@ Start with these foundational examples to learn the SDK:

- [`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)
- [`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)
- [`examples/basic-host`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host) — Bare-bones example of hosting MCP Apps
- [`examples/basic-host`](https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host) — Bare-bones example of hosting MCP Apps (TypeScript/React)
- [`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)

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

Expand Down
12 changes: 12 additions & 0 deletions examples/basic-host-kotlin/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Gradle
.gradle/
build/
!gradle/wrapper/gradle-wrapper.jar
!gradle/wrapper/gradle-wrapper.properties

# IDE
.idea/
*.iml

# Local properties
local.properties
Loading
Loading