create-skybridge 0.0.0-dev.ff23e30 → 0.0.0-dev.ff27ee0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Alpic
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/dist/index.js CHANGED
@@ -3,8 +3,8 @@ import fs from "node:fs";
3
3
  import path from "node:path";
4
4
  import { fileURLToPath } from "node:url";
5
5
  import * as prompts from "@clack/prompts";
6
+ import { downloadTemplate } from "giget";
6
7
  import mri from "mri";
7
- const minimumPnpmVersion = 10;
8
8
  const defaultProjectName = "skybridge-project";
9
9
  // prettier-ignore
10
10
  const helpMessage = `\
@@ -14,21 +14,30 @@ Create a new Skybridge project by copying the starter template.
14
14
 
15
15
  Options:
16
16
  -h, --help show this help message
17
+ --repo <uri> use a git repository instead of the built-in template
17
18
  --overwrite remove existing files in target directory
18
19
  --immediate install dependencies and start development server
19
20
 
21
+ Repository URI formats:
22
+ github:user/repo
23
+ gitlab:user/repo/subdirectory
24
+ bitbucket:user/repo#branch
25
+
20
26
  Examples:
21
27
  create-skybridge my-app
28
+ create-skybridge my-app --repo github:alpic-ai/skybridge/examples/ecom-carousel
22
29
  create-skybridge . --overwrite --immediate
23
30
  `;
24
31
  export async function init(args = process.argv.slice(2)) {
25
32
  const argv = mri(args, {
26
33
  boolean: ["help", "overwrite", "immediate"],
34
+ string: ["repo"],
27
35
  alias: { h: "help" },
28
36
  });
29
37
  const argTargetDir = argv._[0]
30
38
  ? sanitizeTargetDir(String(argv._[0]))
31
39
  : undefined;
40
+ const argRepo = argv.repo;
32
41
  const argOverwrite = argv.overwrite;
33
42
  const argImmediate = argv.immediate;
34
43
  const help = argv.help;
@@ -47,7 +56,7 @@ export async function init(args = process.argv.slice(2)) {
47
56
  defaultValue: defaultProjectName,
48
57
  placeholder: defaultProjectName,
49
58
  validate: (value) => {
50
- return value.length === 0 || sanitizeTargetDir(value).length > 0
59
+ return !value || sanitizeTargetDir(value).length > 0
51
60
  ? undefined
52
61
  : "Invalid project name";
53
62
  },
@@ -96,43 +105,82 @@ export async function init(args = process.argv.slice(2)) {
96
105
  emptyDir(targetDir);
97
106
  break;
98
107
  case "no":
99
- cancel();
100
- return;
108
+ prompts.log.error("Target directory is not empty.");
109
+ process.exit(1);
101
110
  }
102
111
  }
103
112
  const root = path.join(process.cwd(), targetDir);
104
- // 3. Copy the repository
105
- prompts.log.step(`Copying template...`);
113
+ // 3. Download from repo or copy template
106
114
  try {
107
- const templateDir = fileURLToPath(new URL("../template", import.meta.url));
108
- // Copy template to target directory
109
- fs.cpSync(templateDir, root, {
110
- recursive: true,
111
- filter: (src) => !src.endsWith(".npmrc"),
112
- });
113
- // Rename _gitignore to .gitignore
114
- fs.renameSync(path.join(root, "_gitignore"), path.join(root, ".gitignore"));
115
- // Update project name in package.json
116
- const name = path.basename(root);
117
- for (const dir of ["", "server", "web"]) {
118
- const pkgPath = path.join(root, dir, "package.json");
119
- const pkg = fs.readFileSync(pkgPath, "utf-8");
120
- const fixed = pkg.replace(/apps-sdk-template/g, name);
121
- fs.writeFileSync(pkgPath, fixed);
115
+ if (argRepo) {
116
+ prompts.log.step(`Downloading ${argRepo}...`);
117
+ await downloadTemplate(argRepo, { dir: root });
118
+ prompts.log.success(`Project created in ${root}`);
122
119
  }
123
- prompts.log.success(`Project created in ${root}`);
120
+ else {
121
+ prompts.log.step(`Copying template...`);
122
+ const templateDir = fileURLToPath(new URL("../template", import.meta.url));
123
+ // Copy template to target directory
124
+ fs.cpSync(templateDir, root, {
125
+ recursive: true,
126
+ filter: (src) => [".npmrc"].every((file) => !src.endsWith(file)),
127
+ });
128
+ // Rename _gitignore to .gitignore
129
+ fs.renameSync(path.join(root, "_gitignore"), path.join(root, ".gitignore"));
130
+ prompts.log.success(`Project created in ${root}`);
131
+ }
132
+ }
133
+ catch (error) {
134
+ prompts.log.error("Failed to create project from template");
135
+ console.error(error);
136
+ process.exit(1);
137
+ }
138
+ // Update project name in package.json
139
+ const pkgPath = path.join(root, "package.json");
140
+ if (!fs.existsSync(pkgPath)) {
141
+ prompts.log.error("No package.json found in project");
142
+ process.exit(1);
143
+ }
144
+ try {
145
+ const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
146
+ pkg.name = path.basename(root);
147
+ fs.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}\n`);
124
148
  }
125
149
  catch (error) {
126
- prompts.log.error("Failed to copy repository");
150
+ prompts.log.error("Failed to update project name in package.json");
127
151
  console.error(error);
128
152
  process.exit(1);
129
153
  }
130
- // 4. Ask about immediate installation
154
+ const userAgent = process.env.npm_config_user_agent;
155
+ const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
156
+ // 4. Ask about skills installation
157
+ if (interactive) {
158
+ const skillsResult = await prompts.confirm({
159
+ message: "Install the coding agents skills? (recommended)",
160
+ initialValue: true,
161
+ });
162
+ if (prompts.isCancel(skillsResult)) {
163
+ return cancel();
164
+ }
165
+ if (skillsResult) {
166
+ run([
167
+ ...getPkgExecCmd(pkgManager, "skills"),
168
+ "add",
169
+ "alpic-ai/skybridge",
170
+ "-s",
171
+ "chatgpt-app-builder",
172
+ ], {
173
+ stdio: "inherit",
174
+ cwd: targetDir,
175
+ });
176
+ }
177
+ }
178
+ // 5. Ask about immediate installation
131
179
  let immediate = argImmediate;
132
180
  if (immediate === undefined) {
133
181
  if (interactive) {
134
182
  const immediateResult = await prompts.confirm({
135
- message: `Install with pnpm and start now?`,
183
+ message: `Install with ${pkgManager} and start now?`,
136
184
  });
137
185
  if (prompts.isCancel(immediateResult)) {
138
186
  return cancel();
@@ -143,8 +191,20 @@ export async function init(args = process.argv.slice(2)) {
143
191
  immediate = false;
144
192
  }
145
193
  }
146
- const installCmd = ["pnpm", "install"];
147
- const runCmd = ["pnpm", "dev"];
194
+ const installCmd = [pkgManager, "install"];
195
+ const runCmd = [pkgManager];
196
+ switch (pkgManager) {
197
+ case "yarn":
198
+ case "pnpm":
199
+ case "bun":
200
+ break;
201
+ case "deno":
202
+ runCmd.push("task");
203
+ break;
204
+ default:
205
+ runCmd.push("run");
206
+ }
207
+ runCmd.push("dev");
148
208
  if (!immediate) {
149
209
  prompts.outro(`Done! Next steps:
150
210
  cd ${targetDir}
@@ -153,20 +213,7 @@ export async function init(args = process.argv.slice(2)) {
153
213
  `);
154
214
  return;
155
215
  }
156
- // check if pnpm is installed
157
- const result = spawnSync("pnpm", ["--version"], { encoding: "utf-8" });
158
- if (result.error || result.status !== 0) {
159
- console.error("Error: pnpm is not installed. Please install pnpm first.");
160
- process.exit(1);
161
- }
162
- // check if pnpm major is greater or equal to the one set in package.json packageManager, which should do the trick
163
- const version = result.stdout.trim();
164
- const major = Number(version.split(".")[0]);
165
- if (Number.isNaN(major) || major < minimumPnpmVersion) {
166
- console.error(`Error: pnpm version ${version} is too old. Minimum required version is ${minimumPnpmVersion}.`);
167
- process.exit(1);
168
- }
169
- prompts.log.step(`Installing dependencies with pnpm...`);
216
+ prompts.log.step(`Installing dependencies with ${pkgManager}...`);
170
217
  run(installCmd, {
171
218
  stdio: "inherit",
172
219
  cwd: root,
@@ -200,18 +247,37 @@ function sanitizeTargetDir(targetDir) {
200
247
  // Remove leading/trailing slashes
201
248
  .replace(/^\/+|\/+$/g, ""));
202
249
  }
203
- function isEmpty(path) {
204
- const files = fs.readdirSync(path);
205
- return files.length === 0 || (files.length === 1 && files[0] === ".git");
250
+ // Skip user's SPEC.md and IDE/agent preferences (.idea, .claude, etc.)
251
+ function isSkippedEntry(entry) {
252
+ return ((entry.name.startsWith(".") && entry.isDirectory()) ||
253
+ entry.name === "SPEC.md");
254
+ }
255
+ function isEmpty(dirPath) {
256
+ const entries = fs.readdirSync(dirPath, { withFileTypes: true });
257
+ return entries.every(isSkippedEntry);
206
258
  }
207
259
  function emptyDir(dir) {
208
260
  if (!fs.existsSync(dir)) {
209
261
  return;
210
262
  }
211
- for (const file of fs.readdirSync(dir)) {
212
- if (file === ".git") {
263
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
264
+ if (isSkippedEntry(entry)) {
213
265
  continue;
214
266
  }
215
- fs.rmSync(path.resolve(dir, file), { recursive: true, force: true });
267
+ fs.rmSync(path.join(dir, entry.name), { recursive: true, force: true });
268
+ }
269
+ }
270
+ function getPkgExecCmd(pkgManager, cmd) {
271
+ switch (pkgManager) {
272
+ case "yarn":
273
+ return ["yarn", "dlx", cmd];
274
+ case "pnpm":
275
+ return ["pnpm", "dlx", cmd];
276
+ case "bun":
277
+ return ["bunx", cmd];
278
+ case "deno":
279
+ return ["deno", "run", "-A", `npm:${cmd}`];
280
+ default:
281
+ return ["npx", cmd];
216
282
  }
217
283
  }
@@ -14,10 +14,20 @@ describe("create-skybridge", () => {
14
14
  force: true,
15
15
  });
16
16
  });
17
- it("should scaffold a new project", async () => {
17
+ it("should copy the template", async () => {
18
18
  const name = `../../${tempDirName}//project$`;
19
19
  await init([name]);
20
20
  await fs.access(path.join(process.cwd(), tempDirName, "project", ".gitignore"));
21
21
  expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
22
22
  });
23
+ it("should download template from repo", async () => {
24
+ const name = `../../${tempDirName}//project$`;
25
+ await init([
26
+ name,
27
+ "--repo",
28
+ "github:alpic-ai/skybridge/examples/ecom-carousel",
29
+ ]);
30
+ await fs.access(path.join(process.cwd(), tempDirName, "project", ".gitignore"));
31
+ expect(fs.access(path.join(process.cwd(), tempDirName, "project", ".npmrc"))).rejects.toThrowError();
32
+ });
23
33
  });
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-skybridge",
3
- "version": "0.0.0-dev.ff23e30",
3
+ "version": "0.0.0-dev.ff27ee0",
4
4
  "type": "module",
5
5
  "license": "MIT",
6
6
  "author": "Alpic",
@@ -16,21 +16,20 @@
16
16
  "dist",
17
17
  "template"
18
18
  ],
19
- "scripts": {
20
- "build": "tsc",
21
- "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
22
- "test:unit": "vitest run",
23
- "test:type": "tsc --noEmit",
24
- "test:format": "biome ci",
25
- "prepublishOnly": "pnpm run build"
26
- },
27
19
  "dependencies": {
28
- "@clack/prompts": "^0.11.0",
20
+ "@clack/prompts": "^1.0.1",
21
+ "giget": "^3.1.2",
29
22
  "mri": "^1.2.0"
30
23
  },
31
24
  "devDependencies": {
32
- "@types/node": "^25.0.3",
33
25
  "typescript": "^5.9.3",
34
- "vitest": "^2.1.9"
26
+ "vitest": "^4.0.18"
27
+ },
28
+ "scripts": {
29
+ "build": "tsc",
30
+ "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
31
+ "test:unit": "vitest run",
32
+ "test:type": "tsc --noEmit",
33
+ "test:format": "biome ci"
35
34
  }
36
- }
35
+ }
@@ -0,0 +1 @@
1
+ Before writing code, first explore the project structure, then invoke the chatgpt-app-builder skill for documentation.
@@ -1,21 +1,26 @@
1
- # ChatGPT Apps SDK Alpic Starter
1
+ # Skybridge Starter
2
2
 
3
- A minimal TypeScript template for building OpenAI Apps SDK compatible MCP servers with widget rendering in ChatGPT.
3
+ A minimal TypeScript template for building MCP and ChatGPT Apps with the [Skybridge](https://docs.skybridge.tech/home) framework.
4
4
 
5
5
  ## Getting Started
6
6
 
7
7
  ### Prerequisites
8
8
 
9
- - Node.js 22+
10
- - pnpm (install with `npm install -g pnpm`)
11
- - HTTP tunnel such as [ngrok](https://ngrok.com/download)
9
+ - Node.js 24+
10
+ - HTTP tunnel such as [ngrok](https://ngrok.com/download) if you want to test with remote MCP hosts like ChatGPT or Claude.ai.
12
11
 
13
12
  ### Local Development
14
13
 
15
14
  #### 1. Install
16
15
 
17
16
  ```bash
17
+ npm install
18
+ # or
19
+ yarn install
20
+ # or
18
21
  pnpm install
22
+ # or
23
+ bun install
19
24
  ```
20
25
 
21
26
  #### 2. Start your local server
@@ -23,44 +28,70 @@ pnpm install
23
28
  Run the development server from the root directory:
24
29
 
25
30
  ```bash
31
+ npm run dev
32
+ # or
33
+ yarn dev
34
+ # or
26
35
  pnpm dev
36
+ # or
37
+ bun dev
27
38
  ```
28
39
 
29
- This command starts an Express server on port 3000. This server packages:
40
+ This command starts:
41
+ - Your MCP server at `http://localhost:3000/mcp`.
42
+ - Skybridge DevTools UI at `http://localhost:3000/`.
30
43
 
31
- - an MCP endpoint on `/mcp` (the app backend)
32
- - a React application on Vite HMR dev server (the UI elements to be displayed in ChatGPT)
44
+ #### 3. Project structure
33
45
 
34
- #### 3. Connect to ChatGPT
35
-
36
- - ChatGPT requires connectors to be publicly accessible. To expose your server on the Internet, run:
37
- ```bash
38
- ngrok http 3000
39
46
  ```
40
- - In ChatGPT, navigate to **Settings → Connectors → Create** and add the forwarding URL provided by ngrok suffixed with `/mcp` (e.g. `https://3785c5ddc4b6.ngrok-free.app/mcp`)
47
+ ├── server/
48
+ │ └── src/
49
+ │ └── index.ts # Server entry point
50
+ ├── web/
51
+ │ ├── src/
52
+ │ │ ├── widgets/ # React components (one per widget)
53
+ │ │ ├── helpers.ts # Shared utilities
54
+ │ │ └── index.css # Global styles
55
+ │ └── vite.config.ts
56
+ ├── alpic.json # Deployment config
57
+ ├── nodemon.json # Dev server config
58
+ └── package.json
59
+ ```
41
60
 
42
61
  ### Create your first widget
43
62
 
44
63
  #### 1. Add a new widget
45
64
 
46
- - Register a widget in `server/server.ts` with a unique name (e.g., `my-widget`)
47
- - Create a matching React component at `web/src/widgets/my-widget.tsx`. The file name must match the widget name exactly
65
+ - Register a widget in `server/src/server.ts` with a unique name (e.g., `my-widget`) using [`registerWidget`](https://docs.skybridge.tech/api-reference/register-widget)
66
+ - Create a matching React component at `web/src/widgets/my-widget.tsx`. **The file name must match the widget name exactly**.
48
67
 
49
68
  #### 2. Edit widgets with Hot Module Replacement (HMR)
50
69
 
51
- Edit and save components in `web/src/widgets/` — changes appear instantly in ChatGPT
70
+ Edit and save components in `web/src/widgets/` — changes will appear instantly inside your App.
52
71
 
53
72
  #### 3. Edit server code
54
73
 
55
- Modify files in `server/` and reload your ChatGPT connector in **Settings Connectors [Your connector] → Reload**
74
+ Modify files in `server/` and refresh the connection with your testing MCP Client to see the changes.
75
+
76
+ ### Testing your App
77
+
78
+ You can test your App locally by using our DevTools UI on `localhost:3000` while running the `pnpm dev` command.
79
+
80
+ To test your app with other MCP Clients like ChatGPT, Claude or VSCode, see [Testing Your App](https://docs.skybridge.tech/quickstart/test-your-app).
81
+
56
82
 
57
83
  ## Deploy to Production
58
84
 
59
- - Use [Alpic](https://alpic.ai/) to deploy your OpenAI App to production
60
- - In ChatGPT, navigate to **Settings → Connectors → Create** and add your MCP server URL (e.g., `https://your-app-name.alpic.live`)
85
+ Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
61
86
 
62
- ## Resources
87
+ The simplest way to deploy your App in minutes is [Alpic](https://alpic.ai/).
88
+ 1. Create an account on [Alpic platform](https://app.alpic.ai/).
89
+ 2. Connect your GitHub repository to automatically deploy at each commit.
90
+ 3. Use your remote App URL to connect it to MCP Clients, or use the Alpic Playground to easily test your App.
63
91
 
92
+ ## Resources
93
+ - [Skybridge Documentation](https://docs.skybridge.tech/)
64
94
  - [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
95
+ - [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
65
96
  - [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
66
97
  - [Alpic Documentation](https://docs.alpic.ai/)
@@ -1,4 +1,5 @@
1
1
  node_modules/
2
2
  dist/
3
3
  .env*
4
- .DS_store
4
+ .DS_store
5
+ *.tsbuildinfo
@@ -1,4 +1,3 @@
1
1
  {
2
- "$schema": "https://assets.alpic.ai/alpic.json",
3
- "buildOutputDir": "server/dist"
2
+ "$schema": "https://assets.alpic.ai/alpic.json"
4
3
  }
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules/alpic/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules/alpic/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.90.0_@opentelemetry+api@1.9.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../alpic/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../alpic/bin/run.js" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../skybridge/bin/run.js" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules/skybridge/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/skybridge@0.32.0_@modelcontextprotocol+sdk@1.26.0_zod@4.3.6__@skybridge+devtools@0.32.0_48f68782a2196cef65114164dd9a2fc2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
19
+ else
20
+ exec node "$basedir/../skybridge/bin/run.js" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../typescript/bin/tsc" "$@"
19
+ else
20
+ exec node "$basedir/../typescript/bin/tsc" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@5.9.3/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../typescript/bin/tsserver" "$@"
19
+ else
20
+ exec node "$basedir/../typescript/bin/tsserver" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/dist/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../tsx/dist/cli.mjs" "$@"
19
+ else
20
+ exec node "$basedir/../tsx/dist/cli.mjs" "$@"
21
+ fi
@@ -0,0 +1,21 @@
1
+ #!/bin/sh
2
+ basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
3
+
4
+ case `uname` in
5
+ *CYGWIN*|*MINGW*|*MSYS*)
6
+ if command -v cygpath > /dev/null 2>&1; then
7
+ basedir=`cygpath -w "$basedir"`
8
+ fi
9
+ ;;
10
+ esac
11
+
12
+ if [ -z "$NODE_PATH" ]; then
13
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
14
+ else
15
+ export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules/vite/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@7.3.1_@types+node@25.2.3_jiti@2.6.1_lightningcss@1.31.1_terser@5.44.1_tsx@4.21.0_yaml@2.8.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
16
+ fi
17
+ if [ -x "$basedir/node" ]; then
18
+ exec "$basedir/node" "$basedir/../vite/bin/vite.js" "$@"
19
+ else
20
+ exec node "$basedir/../vite/bin/vite.js" "$@"
21
+ fi
@@ -4,18 +4,30 @@
4
4
  "private": true,
5
5
  "description": "Alpic MCP Server Template",
6
6
  "type": "module",
7
- "packageManager": "pnpm@10.18.3",
8
7
  "scripts": {
9
- "dev": "pnpm --filter @apps-sdk-template/server dev",
10
- "build": "pnpm web:build && rm -rf server/dist && pnpm --filter=@apps-sdk-template/server --prod deploy server/dist && cp -r web/dist server/dist/assets && pnpm --filter=@apps-sdk-template/server build",
11
- "start": "pnpm server:start",
12
- "inspector": "pnpm --filter @apps-sdk-template/server inspector",
13
- "server:build": "pnpm --filter @apps-sdk-template/server build",
14
- "server:start": "pnpm --filter @apps-sdk-template/server start",
15
- "web:build": "pnpm --filter @apps-sdk-template/web build",
16
- "web:preview": "pnpm --filter @apps-sdk-template/web preview"
8
+ "dev": "skybridge dev",
9
+ "build": "skybridge build",
10
+ "start": "skybridge start",
11
+ "deploy": "alpic deploy"
12
+ },
13
+ "dependencies": {
14
+ "@modelcontextprotocol/sdk": "^1.26.0",
15
+ "react": "^19.2.4",
16
+ "react-dom": "^19.2.4",
17
+ "skybridge": ">=0.32.0 <1.0.0",
18
+ "vite": "^7.3.1",
19
+ "zod": "^4.3.6"
17
20
  },
18
21
  "devDependencies": {
19
- "tsx": "^4.19.4"
22
+ "@skybridge/devtools": ">=0.32.0 <1.0.0",
23
+ "@types/react": "^19.2.14",
24
+ "@types/react-dom": "^19.2.3",
25
+ "@vitejs/plugin-react": "^5.1.4",
26
+ "alpic": "^1.90.0",
27
+ "tsx": "^4.21.0",
28
+ "typescript": "^5.9.3"
29
+ },
30
+ "engines": {
31
+ "node": ">=24.13.1"
20
32
  }
21
33
  }
@@ -1,35 +1,62 @@
1
- import express, { type Express } from "express";
2
-
3
- import { widgetsDevServer } from "skybridge/server";
4
- import type { ViteDevServer } from "vite";
5
- import { mcp } from "./middleware.js";
6
- import server from "./server.js";
7
-
8
- const app = express() as Express & { vite: ViteDevServer };
9
-
10
- app.use(express.json());
11
-
12
- app.use(mcp(server));
13
-
14
- const env = process.env.NODE_ENV || "development";
15
-
16
- if (env !== "production") {
17
- app.use(await widgetsDevServer());
18
- }
19
-
20
- app.listen(3000, (error) => {
21
- if (error) {
22
- console.error("Failed to start server:", error);
23
- process.exit(1);
24
- }
25
-
26
- console.log(`Server listening on port 3000 - ${env}`);
27
- console.log(
28
- "Make your local server accessible with 'ngrok http 3000' and connect to ChatGPT with URL https://xxxxxx.ngrok-free.app/mcp",
29
- );
30
- });
31
-
32
- process.on("SIGINT", async () => {
33
- console.log("Server shutdown complete");
34
- process.exit(0);
35
- });
1
+ import { McpServer } from "skybridge/server";
2
+ import { z } from "zod";
3
+
4
+ const Answers = [
5
+ "As I see it, yes",
6
+ "Don't count on it",
7
+ "It is certain",
8
+ "It is decidedly so",
9
+ "Most likely",
10
+ "My reply is no",
11
+ "My sources say no",
12
+ "Outlook good",
13
+ "Outlook not so good",
14
+ "Signs point to yes",
15
+ "Very doubtful",
16
+ "Without a doubt",
17
+ "Yes definitely",
18
+ "Yes",
19
+ "You may rely on it",
20
+ ];
21
+
22
+ const server = new McpServer(
23
+ {
24
+ name: "alpic-openai-app",
25
+ version: "0.0.1",
26
+ },
27
+ { capabilities: {} },
28
+ ).registerWidget(
29
+ "magic-8-ball",
30
+ {
31
+ description: "Magic 8 Ball",
32
+ },
33
+ {
34
+ description: "For fortune-telling or seeking advice.",
35
+ inputSchema: {
36
+ question: z.string().describe("The user question."),
37
+ },
38
+ },
39
+ async ({ question }) => {
40
+ try {
41
+ // deterministic answer
42
+ const hash = question
43
+ .split("")
44
+ .reduce((acc, char) => acc + char.charCodeAt(0), 0);
45
+ const answer = Answers[hash % Answers.length];
46
+ return {
47
+ structuredContent: { answer },
48
+ content: [],
49
+ isError: false,
50
+ };
51
+ } catch (error) {
52
+ return {
53
+ content: [{ type: "text", text: `Error: ${error}` }],
54
+ isError: true,
55
+ };
56
+ }
57
+ },
58
+ );
59
+
60
+ server.run();
61
+
62
+ export type AppType = typeof server;
@@ -0,0 +1,9 @@
1
+ {
2
+ "extends": "skybridge/tsconfig",
3
+
4
+ "compilerOptions": {
5
+ "outDir": "dist"
6
+ },
7
+
8
+ "include": ["server/src", "web/src"]
9
+ }
@@ -1,4 +1,4 @@
1
1
  import { generateHelpers } from "skybridge/web";
2
- import type { AppType } from "../../server/src/server";
2
+ import type { AppType } from "../../server/src/index.js";
3
3
 
4
4
  export const { useToolInfo } = generateHelpers<AppType>();
@@ -1,12 +1,23 @@
1
+ @import url("https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@1,600&display=swap");
2
+
1
3
  .container {
2
4
  display: flex;
3
5
  justify-content: center;
4
6
  align-items: center;
5
- height: 100%;
7
+ min-height: 100%;
8
+ max-height: 100%;
9
+ overflow: hidden;
10
+ padding: 1rem;
11
+ box-sizing: border-box;
6
12
  }
7
13
 
8
14
  .ball {
9
- background-color: black;
15
+ background: radial-gradient(
16
+ circle at 30% 30%,
17
+ #454565 0%,
18
+ #1c1c30 40%,
19
+ #0a0a10 100%
20
+ );
10
21
  border-radius: 50%;
11
22
  width: 12rem;
12
23
  height: 12rem;
@@ -15,16 +26,129 @@
15
26
  align-items: center;
16
27
  justify-content: center;
17
28
  font-family: monospace;
29
+ text-align: center;
30
+ position: relative;
31
+ box-shadow:
32
+ 0 10px 30px rgba(0, 0, 0, 0.5),
33
+ 0 5px 15px rgba(0, 0, 0, 0.3),
34
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
35
+ animation:
36
+ float 3s ease-in-out infinite,
37
+ colorShift 15s ease-in-out infinite;
38
+ transition: transform 0.3s ease;
39
+ cursor: pointer;
40
+ border: 1px solid rgba(30, 30, 50, 0.6);
41
+ }
42
+
43
+ .ball:hover {
44
+ transform: scale(1.05) translateY(-8px);
45
+ animation: colorShift 15s ease-in-out infinite;
46
+ box-shadow:
47
+ 0 20px 50px rgba(0, 0, 0, 0.6),
48
+ 0 10px 25px rgba(0, 0, 0, 0.4),
49
+ inset 0 -20px 40px rgba(0, 0, 0, 0.6);
50
+ }
51
+
52
+ @keyframes float {
53
+ 0%,
54
+ 100% {
55
+ transform: translateY(0);
56
+ }
57
+ 50% {
58
+ transform: translateY(-8px);
59
+ }
60
+ }
61
+
62
+ @keyframes colorShift {
63
+ 0%,
64
+ 100% {
65
+ background: radial-gradient(
66
+ circle at 30% 30%,
67
+ #454565 0%,
68
+ #1c1c30 40%,
69
+ #0a0a10 100%
70
+ );
71
+ }
72
+ 25% {
73
+ background: radial-gradient(
74
+ circle at 30% 30%,
75
+ #3f4a65 0%,
76
+ #181e30 40%,
77
+ #090a10 100%
78
+ );
79
+ }
80
+ 50% {
81
+ background: radial-gradient(
82
+ circle at 30% 30%,
83
+ #3a5065 0%,
84
+ #152230 40%,
85
+ #080a10 100%
86
+ );
87
+ }
88
+ 75% {
89
+ background: radial-gradient(
90
+ circle at 30% 30%,
91
+ #3f4a65 0%,
92
+ #181e30 40%,
93
+ #090a10 100%
94
+ );
95
+ }
96
+ }
97
+
98
+ .ball::before {
99
+ content: "";
100
+ position: absolute;
101
+ top: 8%;
102
+ left: 20%;
103
+ width: 30%;
104
+ height: 20%;
105
+ background: radial-gradient(
106
+ ellipse,
107
+ rgba(255, 255, 255, 0.3) 0%,
108
+ transparent 70%
109
+ );
110
+ border-radius: 50%;
111
+ pointer-events: none;
112
+ }
113
+
114
+ .ball::after {
115
+ content: "";
116
+ position: absolute;
117
+ bottom: 8%;
118
+ right: 25%;
119
+ width: 25%;
120
+ height: 10%;
121
+ background: radial-gradient(
122
+ ellipse,
123
+ rgba(255, 255, 255, 0.1) 0%,
124
+ transparent 70%
125
+ );
126
+ border-radius: 50%;
127
+ pointer-events: none;
18
128
  }
19
129
 
20
130
  .question {
21
- font-size: 0.75rem;
131
+ font-size: clamp(0.5rem, 2vw, 0.75rem);
22
132
  color: lightgrey;
133
+ max-width: 90%;
134
+ word-wrap: break-word;
135
+ overflow-wrap: break-word;
136
+ text-align: center;
137
+ line-height: 1.3;
138
+ font-style: italic;
23
139
  }
24
140
 
25
141
  .answer {
26
- font-size: 1.125rem;
27
- font-weight: bold;
142
+ font-family: "Playfair Display", serif;
143
+ font-style: italic;
144
+ font-size: 1.25rem;
145
+ font-weight: 600;
28
146
  margin-top: 0.5rem;
29
- color: aqua;
147
+ color: #7dd3fc;
148
+ text-shadow: 0 0 10px rgba(125, 211, 252, 0.5);
149
+ max-width: 90%;
150
+ word-wrap: break-word;
151
+ overflow-wrap: break-word;
152
+ text-align: center;
153
+ line-height: 1.3;
30
154
  }
@@ -1,19 +1,22 @@
1
1
  import "@/index.css";
2
2
 
3
3
  import { mountWidget } from "skybridge/web";
4
- import { useToolInfo } from "../helpers";
4
+ import { useToolInfo } from "../helpers.js";
5
5
 
6
6
  function Magic8Ball() {
7
7
  const { input, output } = useToolInfo<"magic-8-ball">();
8
- if (!output) {
9
- return <div>Shaking...</div>;
10
- }
11
8
 
12
9
  return (
13
10
  <div className="container">
14
11
  <div className="ball">
15
- <div className="question">{input.question}</div>
16
- <div className="answer">{output.answer}</div>
12
+ {output ? (
13
+ <>
14
+ <div className="question">{input.question}</div>
15
+ <div className="answer">{output.answer}</div>
16
+ </>
17
+ ) : (
18
+ <div className="question">Shaking...</div>
19
+ )}
17
20
  </div>
18
21
  </div>
19
22
  );
@@ -1,12 +1,12 @@
1
1
  import path from "node:path";
2
2
  import react from "@vitejs/plugin-react";
3
3
  import { skybridge } from "skybridge/web";
4
- import { defineConfig } from "vite";
4
+ import { defineConfig, type PluginOption } from "vite";
5
5
 
6
6
  // https://vite.dev/config/
7
7
  export default defineConfig({
8
- plugins: [skybridge(), react()],
9
-
8
+ plugins: [skybridge() as PluginOption, react()],
9
+ root: __dirname,
10
10
  resolve: {
11
11
  alias: {
12
12
  "@": path.resolve(__dirname, "./src"),
@@ -1,7 +0,0 @@
1
- packages:
2
- - "web"
3
- - "server"
4
- sharedWorkspaceLockfile: false
5
-
6
- catalog:
7
- skybridge: ^0.13.1
@@ -1,5 +0,0 @@
1
- {
2
- "watch": ["src/**/*"],
3
- "ext": "ts,js,json",
4
- "exec": "tsx src/index.ts"
5
- }
@@ -1,32 +0,0 @@
1
- {
2
- "name": "@apps-sdk-template/server",
3
- "version": "0.0.1",
4
- "private": true,
5
- "main": "dist/index.js",
6
- "description": "Alpic MCP Server Template",
7
- "files": [
8
- "dist"
9
- ],
10
- "type": "module",
11
- "scripts": {
12
- "dev": "nodemon",
13
- "build": "tsc",
14
- "start": "node dist/index.js",
15
- "inspector": "mcp-inspector http://localhost:3000/mcp"
16
- },
17
- "dependencies": {
18
- "@modelcontextprotocol/sdk": "^1.24.3",
19
- "express": "^5.1.0",
20
- "skybridge": "catalog:",
21
- "vite": "^7.1.11",
22
- "zod": "^4.1.13"
23
- },
24
- "devDependencies": {
25
- "@modelcontextprotocol/inspector": "^0.17.5",
26
- "@types/express": "^5.0.3",
27
- "@types/node": "^22.15.30",
28
- "nodemon": "^3.1.10",
29
- "tsx": "^4.19.2",
30
- "typescript": "^5.7.2"
31
- }
32
- }
@@ -1,54 +0,0 @@
1
- import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
2
- import type { NextFunction, Request, Response } from "express";
3
-
4
- import type { McpServer } from "skybridge/server";
5
-
6
- export const mcp =
7
- (server: McpServer) =>
8
- async (req: Request, res: Response, next: NextFunction) => {
9
- // Only handle requests to the /mcp path
10
- if (req.path !== "/mcp") {
11
- return next();
12
- }
13
-
14
- if (req.method === "POST") {
15
- try {
16
- const transport = new StreamableHTTPServerTransport({
17
- sessionIdGenerator: undefined,
18
- });
19
-
20
- res.on("close", () => {
21
- transport.close();
22
- });
23
-
24
- await server.connect(transport);
25
-
26
- await transport.handleRequest(req, res, req.body);
27
- } catch (error) {
28
- console.error("Error handling MCP request:", error);
29
- if (!res.headersSent) {
30
- res.status(500).json({
31
- jsonrpc: "2.0",
32
- error: {
33
- code: -32603,
34
- message: "Internal server error",
35
- },
36
- id: null,
37
- });
38
- }
39
- }
40
- } else if (req.method === "GET" || req.method === "DELETE") {
41
- res.writeHead(405).end(
42
- JSON.stringify({
43
- jsonrpc: "2.0",
44
- error: {
45
- code: -32000,
46
- message: "Method not allowed.",
47
- },
48
- id: null,
49
- }),
50
- );
51
- } else {
52
- next();
53
- }
54
- };
@@ -1,66 +0,0 @@
1
- import { McpServer } from "skybridge/server";
2
- import { z } from "zod";
3
-
4
- const Answers = [
5
- "As I see it, yes",
6
- "Ask again later",
7
- "Better not tell you now",
8
- "Cannot predict now",
9
- "Concentrate and ask again",
10
- "Don't count on it",
11
- "It is certain",
12
- "It is decidedly so",
13
- "Most likely",
14
- "My reply is no",
15
- "My sources say no",
16
- "Outlook good",
17
- "Outlook not so good",
18
- "Reply hazy, try again",
19
- "Signs point to yes",
20
- "Very doubtful",
21
- "Without a doubt",
22
- "Yes definitely",
23
- "Yes",
24
- "You may rely on it",
25
- ];
26
-
27
- const server = new McpServer(
28
- {
29
- name: "alpic-openai-app",
30
- version: "0.0.1",
31
- },
32
- { capabilities: {} },
33
- ).registerWidget(
34
- "magic-8-ball",
35
- {
36
- description: "Magic 8 Ball",
37
- },
38
- {
39
- description: "For fortune-telling or seeking advice.",
40
- inputSchema: {
41
- question: z.string().describe("The user question."),
42
- },
43
- },
44
- async ({ question }) => {
45
- try {
46
- // deterministic answer
47
- const hash = question
48
- .split("")
49
- .reduce((acc, char) => acc + char.charCodeAt(0), 0);
50
- const answer = Answers[hash % Answers.length];
51
- return {
52
- structuredContent: { answer },
53
- content: [],
54
- isError: false,
55
- };
56
- } catch (error) {
57
- return {
58
- content: [{ type: "text", text: `Error: ${error}` }],
59
- isError: true,
60
- };
61
- }
62
- },
63
- );
64
-
65
- export default server;
66
- export type AppType = typeof server;
@@ -1,17 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "target": "ESNext",
4
- "module": "ESNext",
5
- "moduleResolution": "bundler",
6
- "esModuleInterop": true,
7
- "strict": true,
8
- "skipLibCheck": true,
9
- "forceConsistentCasingInFileNames": true,
10
- "outDir": "dist",
11
- "sourceMap": true,
12
- "jsx": "react",
13
- "inlineSources": true
14
- },
15
- "include": ["**/*.ts", "**/*.tsx"],
16
- "exclude": ["dist", "node_modules"]
17
- }
@@ -1,24 +0,0 @@
1
- {
2
- "name": "@apps-sdk-template/web",
3
- "private": true,
4
- "version": "0.0.0",
5
- "type": "module",
6
- "scripts": {
7
- "dev": "echo 'Not implemented",
8
- "build": "tsc -b && vite build",
9
- "preview": "vite preview"
10
- },
11
- "dependencies": {
12
- "skybridge": "catalog:",
13
- "react": "^19.1.1",
14
- "react-dom": "^19.1.1"
15
- },
16
- "devDependencies": {
17
- "@types/node": "^24.6.0",
18
- "@types/react": "^19.1.16",
19
- "@types/react-dom": "^19.1.9",
20
- "@vitejs/plugin-react": "^5.0.4",
21
- "typescript": "~5.9.3",
22
- "vite": "^7.1.11"
23
- }
24
- }
@@ -1,34 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
4
- "target": "ES2022",
5
- "useDefineForClassFields": true,
6
- "lib": ["ES2022", "DOM", "DOM.Iterable"],
7
- "module": "ESNext",
8
- "types": ["vite/client"],
9
- "skipLibCheck": true,
10
-
11
- /* Bundler mode */
12
- "moduleResolution": "bundler",
13
- "allowImportingTsExtensions": true,
14
- "verbatimModuleSyntax": true,
15
- "moduleDetection": "force",
16
- "noEmit": true,
17
- "jsx": "react-jsx",
18
-
19
- /* Linting */
20
- "strict": true,
21
- "noUnusedLocals": true,
22
- "noUnusedParameters": true,
23
- "erasableSyntaxOnly": true,
24
- "noFallthroughCasesInSwitch": true,
25
- "noUncheckedSideEffectImports": true,
26
-
27
- /* Shadcn Config */
28
- "baseUrl": ".",
29
- "paths": {
30
- "@/*": ["./src/*"]
31
- }
32
- },
33
- "include": ["src"]
34
- }
@@ -1,13 +0,0 @@
1
- {
2
- "files": [],
3
- "references": [
4
- { "path": "./tsconfig.app.json" },
5
- { "path": "./tsconfig.node.json" }
6
- ],
7
- "compilerOptions": {
8
- "baseUrl": ".",
9
- "paths": {
10
- "@/*": ["./src/*"]
11
- }
12
- }
13
- }
@@ -1,26 +0,0 @@
1
- {
2
- "compilerOptions": {
3
- "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
4
- "target": "ES2023",
5
- "lib": ["ES2023"],
6
- "module": "ESNext",
7
- "types": ["node"],
8
- "skipLibCheck": true,
9
-
10
- /* Bundler mode */
11
- "moduleResolution": "bundler",
12
- "allowImportingTsExtensions": true,
13
- "verbatimModuleSyntax": true,
14
- "moduleDetection": "force",
15
- "noEmit": true,
16
-
17
- /* Linting */
18
- "strict": true,
19
- "noUnusedLocals": true,
20
- "noUnusedParameters": true,
21
- "erasableSyntaxOnly": true,
22
- "noFallthroughCasesInSwitch": true,
23
- "noUncheckedSideEffectImports": true
24
- },
25
- "include": ["vite.config.ts"]
26
- }