create-skybridge 0.0.0-dev.e62cd20 → 0.0.0-dev.e63ef1f
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/dist/index.js +20 -15
- package/dist/index.test.js +2 -2
- package/package.json +6 -5
- package/template/AGENTS.md +1 -1
- package/template/README.md +38 -21
- package/template/_gitignore +2 -1
- package/template/node_modules/.bin/alpic +21 -0
- package/template/node_modules/.bin/sb +2 -2
- package/template/node_modules/.bin/skybridge +2 -2
- package/template/node_modules/.bin/tsc +2 -2
- package/template/node_modules/.bin/tsserver +2 -2
- package/template/node_modules/.bin/tsx +2 -2
- package/template/node_modules/.bin/vite +2 -2
- package/template/package.json +12 -15
- package/template/src/components/ball.tsx +22 -0
- package/template/src/helpers.ts +4 -0
- package/template/{web/src → src}/index.css +0 -2
- package/template/{server/src → src}/server.ts +8 -8
- package/template/src/views/magic-8-ball.tsx +10 -0
- package/template/tsconfig.json +7 -19
- package/template/{web/vite.config.ts → vite.config.ts} +2 -4
- package/template/node_modules/.bin/mcp-inspector +0 -21
- package/template/node_modules/.bin/nodemon +0 -21
- package/template/nodemon.json +0 -5
- package/template/server/src/index.ts +0 -42
- package/template/server/src/middleware.ts +0 -54
- package/template/tsconfig.server.json +0 -11
- package/template/web/src/helpers.ts +0 -4
- package/template/web/src/widgets/magic-8-ball.tsx +0 -24
package/dist/index.js
CHANGED
|
@@ -56,7 +56,7 @@ export async function init(args = process.argv.slice(2)) {
|
|
|
56
56
|
defaultValue: defaultProjectName,
|
|
57
57
|
placeholder: defaultProjectName,
|
|
58
58
|
validate: (value) => {
|
|
59
|
-
return value
|
|
59
|
+
return !value || sanitizeTargetDir(value).length > 0
|
|
60
60
|
? undefined
|
|
61
61
|
: "Invalid project name";
|
|
62
62
|
},
|
|
@@ -153,7 +153,8 @@ export async function init(args = process.argv.slice(2)) {
|
|
|
153
153
|
}
|
|
154
154
|
const userAgent = process.env.npm_config_user_agent;
|
|
155
155
|
const pkgManager = userAgent?.split(" ")[0]?.split("/")[0] || "npm";
|
|
156
|
-
// 4. Ask about skills installation
|
|
156
|
+
// 4. Ask about skills installation (installed by default)
|
|
157
|
+
let skill = true;
|
|
157
158
|
if (interactive) {
|
|
158
159
|
const skillsResult = await prompts.confirm({
|
|
159
160
|
message: "Install the coding agents skills? (recommended)",
|
|
@@ -162,18 +163,22 @@ export async function init(args = process.argv.slice(2)) {
|
|
|
162
163
|
if (prompts.isCancel(skillsResult)) {
|
|
163
164
|
return cancel();
|
|
164
165
|
}
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
166
|
+
skill = skillsResult;
|
|
167
|
+
}
|
|
168
|
+
if (skill) {
|
|
169
|
+
run([
|
|
170
|
+
...getPkgExecCmd(pkgManager, "skills"),
|
|
171
|
+
"add",
|
|
172
|
+
"alpic-ai/skybridge",
|
|
173
|
+
"-s",
|
|
174
|
+
"chatgpt-app-builder",
|
|
175
|
+
...(interactive
|
|
176
|
+
? []
|
|
177
|
+
: ["--yes", "-a", "universal", "-a", "claude-code"]),
|
|
178
|
+
], {
|
|
179
|
+
stdio: "inherit",
|
|
180
|
+
cwd: targetDir,
|
|
181
|
+
});
|
|
177
182
|
}
|
|
178
183
|
// 5. Ask about immediate installation
|
|
179
184
|
let immediate = argImmediate;
|
|
@@ -278,6 +283,6 @@ function getPkgExecCmd(pkgManager, cmd) {
|
|
|
278
283
|
case "deno":
|
|
279
284
|
return ["deno", "run", "-A", `npm:${cmd}`];
|
|
280
285
|
default:
|
|
281
|
-
return ["npx", cmd];
|
|
286
|
+
return ["npx", "--yes", cmd];
|
|
282
287
|
}
|
|
283
288
|
}
|
package/dist/index.test.js
CHANGED
|
@@ -14,13 +14,13 @@ describe("create-skybridge", () => {
|
|
|
14
14
|
force: true,
|
|
15
15
|
});
|
|
16
16
|
});
|
|
17
|
-
it("should copy the template", async () => {
|
|
17
|
+
it("should copy the template", { timeout: 10000 }, 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 () => {
|
|
23
|
+
it("should download template from repo", { timeout: 10000 }, async () => {
|
|
24
24
|
const name = `../../${tempDirName}//project$`;
|
|
25
25
|
await init([
|
|
26
26
|
name,
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-skybridge",
|
|
3
|
-
"version": "0.0.0-dev.
|
|
3
|
+
"version": "0.0.0-dev.e63ef1f",
|
|
4
4
|
"type": "module",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "Alpic",
|
|
@@ -17,19 +17,20 @@
|
|
|
17
17
|
"template"
|
|
18
18
|
],
|
|
19
19
|
"dependencies": {
|
|
20
|
-
"@clack/prompts": "^
|
|
21
|
-
"giget": "^2.0
|
|
20
|
+
"@clack/prompts": "^1.1.0",
|
|
21
|
+
"giget": "^3.2.0",
|
|
22
22
|
"mri": "^1.2.0"
|
|
23
23
|
},
|
|
24
24
|
"devDependencies": {
|
|
25
|
-
"typescript": "^
|
|
26
|
-
"vitest": "^4.
|
|
25
|
+
"typescript": "^6.0.2",
|
|
26
|
+
"vitest": "^4.1.4"
|
|
27
27
|
},
|
|
28
28
|
"scripts": {
|
|
29
29
|
"build": "tsc",
|
|
30
30
|
"test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
|
|
31
31
|
"test:unit": "vitest run",
|
|
32
32
|
"test:type": "tsc --noEmit",
|
|
33
|
+
"format": "biome check --write --error-on-warnings",
|
|
33
34
|
"test:format": "biome ci"
|
|
34
35
|
}
|
|
35
36
|
}
|
package/template/AGENTS.md
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
This is a ChatGPT/MCP app built with Skybridge. ALWAYS use the `chatgpt-app-builder` skill when planning or updating the codebase.
|
package/template/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# Skybridge Starter
|
|
2
2
|
|
|
3
|
-
A minimal TypeScript template for building
|
|
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
9
|
- Node.js 24+
|
|
10
|
-
- HTTP tunnel such as [
|
|
10
|
+
- HTTP tunnel such as [Alpic tunnel](https://docs.alpic.ai/cli/tunnel) if you want to test with remote MCP hosts like ChatGPT or Claude.ai.
|
|
11
11
|
|
|
12
12
|
### Local Development
|
|
13
13
|
|
|
@@ -37,41 +37,58 @@ pnpm dev
|
|
|
37
37
|
bun dev
|
|
38
38
|
```
|
|
39
39
|
|
|
40
|
-
This command starts
|
|
40
|
+
This command starts:
|
|
41
|
+
- Your MCP server at `http://localhost:3000/mcp`.
|
|
42
|
+
- Skybridge DevTools UI at `http://localhost:3000/`.
|
|
41
43
|
|
|
42
|
-
|
|
43
|
-
- a React application on Vite HMR dev server (the UI elements to be displayed in the host)
|
|
44
|
+
#### 3. Project structure
|
|
44
45
|
|
|
45
|
-
#### 3. Connect to ChatGPT
|
|
46
|
-
|
|
47
|
-
- ChatGPT requires connectors to be publicly accessible. To expose your server on the Internet, run:
|
|
48
|
-
```bash
|
|
49
|
-
ngrok http 3000
|
|
50
46
|
```
|
|
51
|
-
|
|
47
|
+
├── src/
|
|
48
|
+
│ ├── server.ts # Server entry point
|
|
49
|
+
│ ├── views/ # React components (one per view)
|
|
50
|
+
│ ├── components/ # Shared UI components
|
|
51
|
+
│ ├── helpers.ts # Shared utilities
|
|
52
|
+
│ └── index.css # Global styles
|
|
53
|
+
├── vite.config.ts
|
|
54
|
+
├── alpic.json # Deployment config
|
|
55
|
+
└── package.json
|
|
56
|
+
```
|
|
52
57
|
|
|
53
|
-
### Create your first
|
|
58
|
+
### Create your first view
|
|
54
59
|
|
|
55
|
-
#### 1. Add a new
|
|
60
|
+
#### 1. Add a new view
|
|
56
61
|
|
|
57
|
-
- Register a
|
|
58
|
-
- Create a matching React component at `
|
|
62
|
+
- Register a tool in `src/server.ts` with a unique name (e.g., `my-view`) using [`registerTool`](https://docs.skybridge.tech/api-reference/register-tool) and a `view` config.
|
|
63
|
+
- Create a matching React component at `src/views/my-view.tsx`. **The file name must match the view name exactly**.
|
|
59
64
|
|
|
60
|
-
#### 2. Edit
|
|
65
|
+
#### 2. Edit views with Hot Module Replacement (HMR)
|
|
61
66
|
|
|
62
|
-
Edit and save components in `
|
|
67
|
+
Edit and save components in `src/views/` — changes will appear instantly inside your App.
|
|
63
68
|
|
|
64
69
|
#### 3. Edit server code
|
|
65
70
|
|
|
66
|
-
Modify files in `
|
|
71
|
+
Modify files in `src/` and refresh the connection with your testing MCP Client to see the changes.
|
|
72
|
+
|
|
73
|
+
### Testing your App
|
|
74
|
+
|
|
75
|
+
You can test your App locally by using our DevTools UI on `localhost:3000` while running the `pnpm dev` command.
|
|
76
|
+
|
|
77
|
+
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).
|
|
78
|
+
|
|
67
79
|
|
|
68
80
|
## Deploy to Production
|
|
69
81
|
|
|
70
|
-
|
|
71
|
-
- In ChatGPT, navigate to **Settings → Connectors → Create** and add your MCP server URL (e.g., `https://your-app-name.alpic.live`)
|
|
82
|
+
Skybridge is infrastructure vendor agnostic, and your app can be deployed on any cloud platform supporting MCP.
|
|
72
83
|
|
|
73
|
-
|
|
84
|
+
The simplest way to deploy your App in minutes is [Alpic](https://alpic.ai/).
|
|
85
|
+
1. Create an account on [Alpic platform](https://app.alpic.ai/).
|
|
86
|
+
2. Connect your GitHub repository to automatically deploy at each commit.
|
|
87
|
+
3. Use your remote App URL to connect it to MCP Clients, or use the Alpic Playground to easily test your App.
|
|
74
88
|
|
|
89
|
+
## Resources
|
|
90
|
+
- [Skybridge Documentation](https://docs.skybridge.tech/)
|
|
75
91
|
- [Apps SDK Documentation](https://developers.openai.com/apps-sdk)
|
|
92
|
+
- [MCP Apps Documentation](https://github.com/modelcontextprotocol/ext-apps/tree/main)
|
|
76
93
|
- [Model Context Protocol Documentation](https://modelcontextprotocol.io/)
|
|
77
94
|
- [Alpic Documentation](https://docs.alpic.ai/)
|
package/template/_gitignore
CHANGED
|
@@ -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.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.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/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.2/node_modules/alpic/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/alpic@1.104.1_@opentelemetry+api@1.9.0_arktype@2.1.27_rxjs@7.8.2_typescript@6.0.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/../alpic/bin/run.js" "$@"
|
|
19
|
+
else
|
|
20
|
+
exec node "$basedir/../alpic/bin/run.js" "$@"
|
|
21
|
+
fi
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
12
|
if [ -z "$NODE_PATH" ]; then
|
|
13
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/
|
|
13
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
|
|
14
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/
|
|
15
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
|
|
16
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
12
|
if [ -z "$NODE_PATH" ]; then
|
|
13
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/
|
|
13
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
|
|
14
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/
|
|
15
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
|
|
16
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../skybridge/bin/run.js" "$@"
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
12
|
if [ -z "$NODE_PATH" ]; then
|
|
13
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@
|
|
13
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
|
|
14
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@
|
|
15
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
|
|
16
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../typescript/bin/tsc" "$@"
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
12
|
if [ -z "$NODE_PATH" ]; then
|
|
13
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@
|
|
13
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules"
|
|
14
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@
|
|
15
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules/typescript/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/typescript@6.0.2/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/node_modules:$NODE_PATH"
|
|
16
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../typescript/bin/tsserver" "$@"
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
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/
|
|
13
|
+
export NODE_PATH="/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
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/tsx@4.21.0/node_modules/tsx/
|
|
15
|
+
export NODE_PATH="/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
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../tsx/dist/cli.mjs" "$@"
|
|
@@ -10,9 +10,9 @@ case `uname` in
|
|
|
10
10
|
esac
|
|
11
11
|
|
|
12
12
|
if [ -z "$NODE_PATH" ]; then
|
|
13
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@
|
|
13
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.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@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.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
14
|
else
|
|
15
|
-
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@
|
|
15
|
+
export NODE_PATH="/home/runner/work/skybridge/skybridge/node_modules/.pnpm/vite@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.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@8.0.3_@types+node@24.12.0_esbuild@0.27.2_jiti@2.6.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
16
|
fi
|
|
17
17
|
if [ -x "$basedir/node" ]; then
|
|
18
18
|
exec "$basedir/node" "$basedir/../vite/bin/vite.js" "$@"
|
package/template/package.json
CHANGED
|
@@ -6,33 +6,30 @@
|
|
|
6
6
|
"type": "module",
|
|
7
7
|
"scripts": {
|
|
8
8
|
"dev": "skybridge dev",
|
|
9
|
+
"dev:tunnel": "skybridge dev --tunnel",
|
|
9
10
|
"build": "skybridge build",
|
|
10
11
|
"start": "skybridge start",
|
|
11
|
-
"
|
|
12
|
+
"deploy": "alpic deploy"
|
|
12
13
|
},
|
|
13
14
|
"dependencies": {
|
|
14
|
-
"@modelcontextprotocol/sdk": "^1.
|
|
15
|
-
"cors": "^2.8.6",
|
|
16
|
-
"express": "^5.2.1",
|
|
15
|
+
"@modelcontextprotocol/sdk": "^1.29.0",
|
|
17
16
|
"react": "^19.2.4",
|
|
18
17
|
"react-dom": "^19.2.4",
|
|
19
|
-
"skybridge": ">=0.
|
|
20
|
-
"vite": "^
|
|
18
|
+
"skybridge": ">=0.0.0-dev.e63ef1f",
|
|
19
|
+
"vite": "^8.0.3",
|
|
21
20
|
"zod": "^4.3.6"
|
|
22
21
|
},
|
|
23
22
|
"devDependencies": {
|
|
24
|
-
"@
|
|
25
|
-
"@
|
|
26
|
-
"@types/
|
|
27
|
-
"@types/express": "^5.0.6",
|
|
28
|
-
"@types/react": "^19.2.11",
|
|
23
|
+
"@skybridge/devtools": ">=0.35.14 <1.0.0",
|
|
24
|
+
"@types/node": "^24.12.0",
|
|
25
|
+
"@types/react": "^19.2.14",
|
|
29
26
|
"@types/react-dom": "^19.2.3",
|
|
30
|
-
"@vitejs/plugin-react": "^
|
|
31
|
-
"
|
|
27
|
+
"@vitejs/plugin-react": "^6.0.1",
|
|
28
|
+
"alpic": "^1.104.1",
|
|
32
29
|
"tsx": "^4.21.0",
|
|
33
|
-
"typescript": "^
|
|
30
|
+
"typescript": "^6.0.2"
|
|
34
31
|
},
|
|
35
32
|
"engines": {
|
|
36
|
-
"node": ">=24.
|
|
33
|
+
"node": ">=24.14.1"
|
|
37
34
|
}
|
|
38
35
|
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
export function Ball({
|
|
2
|
+
question,
|
|
3
|
+
answer,
|
|
4
|
+
}: {
|
|
5
|
+
question?: string;
|
|
6
|
+
answer?: string;
|
|
7
|
+
}) {
|
|
8
|
+
return (
|
|
9
|
+
<div className="container">
|
|
10
|
+
<div className="ball">
|
|
11
|
+
{answer ? (
|
|
12
|
+
<>
|
|
13
|
+
<div className="question">{question}</div>
|
|
14
|
+
<div className="answer">{answer}</div>
|
|
15
|
+
</>
|
|
16
|
+
) : (
|
|
17
|
+
<div className="question">Shaking...</div>
|
|
18
|
+
)}
|
|
19
|
+
</div>
|
|
20
|
+
</div>
|
|
21
|
+
);
|
|
22
|
+
}
|
|
@@ -25,27 +25,26 @@ const server = new McpServer(
|
|
|
25
25
|
version: "0.0.1",
|
|
26
26
|
},
|
|
27
27
|
{ capabilities: {} },
|
|
28
|
-
).
|
|
29
|
-
"magic-8-ball",
|
|
30
|
-
{
|
|
31
|
-
description: "Magic 8 Ball",
|
|
32
|
-
},
|
|
28
|
+
).registerTool(
|
|
33
29
|
{
|
|
30
|
+
name: "magic-8-ball",
|
|
34
31
|
description: "For fortune-telling or seeking advice.",
|
|
35
32
|
inputSchema: {
|
|
36
33
|
question: z.string().describe("The user question."),
|
|
37
34
|
},
|
|
35
|
+
view: {
|
|
36
|
+
component: "magic-8-ball",
|
|
37
|
+
description: "Magic 8 Ball",
|
|
38
|
+
},
|
|
38
39
|
},
|
|
39
40
|
async ({ question }) => {
|
|
40
41
|
try {
|
|
41
|
-
// deterministic answer
|
|
42
42
|
const hash = question
|
|
43
43
|
.split("")
|
|
44
44
|
.reduce((acc, char) => acc + char.charCodeAt(0), 0);
|
|
45
45
|
const answer = Answers[hash % Answers.length];
|
|
46
46
|
return {
|
|
47
47
|
structuredContent: { answer },
|
|
48
|
-
content: [],
|
|
49
48
|
isError: false,
|
|
50
49
|
};
|
|
51
50
|
} catch (error) {
|
|
@@ -57,5 +56,6 @@ const server = new McpServer(
|
|
|
57
56
|
},
|
|
58
57
|
);
|
|
59
58
|
|
|
60
|
-
|
|
59
|
+
server.run();
|
|
60
|
+
|
|
61
61
|
export type AppType = typeof server;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import "@/index.css";
|
|
2
|
+
|
|
3
|
+
import { Ball } from "../components/ball.js";
|
|
4
|
+
import { useToolInfo } from "../helpers.js";
|
|
5
|
+
|
|
6
|
+
export default function Magic8Ball() {
|
|
7
|
+
const { input, output } = useToolInfo<"magic-8-ball">();
|
|
8
|
+
|
|
9
|
+
return <Ball question={input?.question} answer={output?.answer} />;
|
|
10
|
+
}
|
package/template/tsconfig.json
CHANGED
|
@@ -1,23 +1,11 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
3
|
-
"target": "ES2022",
|
|
4
|
-
"module": "ESNext",
|
|
5
|
-
"moduleResolution": "bundler",
|
|
6
|
-
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
7
|
-
"jsx": "react-jsx",
|
|
8
|
-
|
|
9
|
-
"strict": true,
|
|
10
|
-
"skipLibCheck": true,
|
|
11
|
-
"esModuleInterop": true,
|
|
12
|
-
"forceConsistentCasingInFileNames": true,
|
|
13
|
-
"verbatimModuleSyntax": true,
|
|
14
|
-
|
|
15
|
-
"noUnusedLocals": true,
|
|
16
|
-
"noUnusedParameters": true,
|
|
17
|
-
"noFallthroughCasesInSwitch": true,
|
|
2
|
+
"extends": "skybridge/tsconfig",
|
|
18
3
|
|
|
19
|
-
|
|
4
|
+
"compilerOptions": {
|
|
5
|
+
"paths": {
|
|
6
|
+
"@/*": ["./src/*"]
|
|
7
|
+
}
|
|
20
8
|
},
|
|
21
|
-
|
|
22
|
-
"
|
|
9
|
+
|
|
10
|
+
"include": ["src", ".skybridge/**/*.d.ts"]
|
|
23
11
|
}
|
|
@@ -1,12 +1,10 @@
|
|
|
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
|
|
4
|
+
import { defineConfig } from "vite";
|
|
5
5
|
|
|
6
|
-
// https://vite.dev/config/
|
|
7
6
|
export default defineConfig({
|
|
8
|
-
plugins: [skybridge()
|
|
9
|
-
root: __dirname,
|
|
7
|
+
plugins: [skybridge(), react()],
|
|
10
8
|
resolve: {
|
|
11
9
|
alias: {
|
|
12
10
|
"@": path.resolve(__dirname, "./src"),
|
|
@@ -1,21 +0,0 @@
|
|
|
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/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/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/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/cli/build/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/cli/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/inspector/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/node_modules/@modelcontextprotocol/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/@modelcontextprotocol+inspector@0.19.0_@types+node@24.10.10_@types+react-dom@19.2.3_@ty_f7a7da5ac88175659d17063bec678ef2/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/../@modelcontextprotocol/inspector/cli/build/cli.js" "$@"
|
|
19
|
-
else
|
|
20
|
-
exec node "$basedir/../@modelcontextprotocol/inspector/cli/build/cli.js" "$@"
|
|
21
|
-
fi
|
|
@@ -1,21 +0,0 @@
|
|
|
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/nodemon@3.1.11/node_modules/nodemon/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/nodemon@3.1.11/node_modules/nodemon/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/nodemon@3.1.11/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/nodemon@3.1.11/node_modules/nodemon/bin/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/nodemon@3.1.11/node_modules/nodemon/node_modules:/home/runner/work/skybridge/skybridge/node_modules/.pnpm/nodemon@3.1.11/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/../nodemon/bin/nodemon.js" "$@"
|
|
19
|
-
else
|
|
20
|
-
exec node "$basedir/../nodemon/bin/nodemon.js" "$@"
|
|
21
|
-
fi
|
package/template/nodemon.json
DELETED
|
@@ -1,42 +0,0 @@
|
|
|
1
|
-
import path from "node:path";
|
|
2
|
-
import { fileURLToPath } from "node:url";
|
|
3
|
-
import cors from "cors";
|
|
4
|
-
import express, { type Express } from "express";
|
|
5
|
-
import { widgetsDevServer } from "skybridge/server";
|
|
6
|
-
import type { ViteDevServer } from "vite";
|
|
7
|
-
import { mcp } from "./middleware.js";
|
|
8
|
-
import server from "./server.js";
|
|
9
|
-
|
|
10
|
-
const app = express() as Express & { vite: ViteDevServer };
|
|
11
|
-
|
|
12
|
-
app.use(express.json());
|
|
13
|
-
|
|
14
|
-
app.use(mcp(server));
|
|
15
|
-
|
|
16
|
-
const env = process.env.NODE_ENV || "development";
|
|
17
|
-
|
|
18
|
-
if (env !== "production") {
|
|
19
|
-
const { devtoolsStaticServer } = await import("@skybridge/devtools");
|
|
20
|
-
app.use(await devtoolsStaticServer());
|
|
21
|
-
app.use(await widgetsDevServer());
|
|
22
|
-
}
|
|
23
|
-
|
|
24
|
-
if (env === "production") {
|
|
25
|
-
const __filename = fileURLToPath(import.meta.url);
|
|
26
|
-
const __dirname = path.dirname(__filename);
|
|
27
|
-
|
|
28
|
-
app.use("/assets", cors());
|
|
29
|
-
app.use("/assets", express.static(path.join(__dirname, "assets")));
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
app.listen(3000, (error) => {
|
|
33
|
-
if (error) {
|
|
34
|
-
console.error("Failed to start server:", error);
|
|
35
|
-
process.exit(1);
|
|
36
|
-
}
|
|
37
|
-
});
|
|
38
|
-
|
|
39
|
-
process.on("SIGINT", async () => {
|
|
40
|
-
console.log("Server shutdown complete");
|
|
41
|
-
process.exit(0);
|
|
42
|
-
});
|
|
@@ -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,24 +0,0 @@
|
|
|
1
|
-
import "@/index.css";
|
|
2
|
-
|
|
3
|
-
import { mountWidget } from "skybridge/web";
|
|
4
|
-
import { useToolInfo } from "../helpers";
|
|
5
|
-
|
|
6
|
-
function Magic8Ball() {
|
|
7
|
-
const { input, output } = useToolInfo<"magic-8-ball">();
|
|
8
|
-
if (!output) {
|
|
9
|
-
return <div>Shaking...</div>;
|
|
10
|
-
}
|
|
11
|
-
|
|
12
|
-
return (
|
|
13
|
-
<div className="container">
|
|
14
|
-
<div className="ball">
|
|
15
|
-
<div className="question">{input.question}</div>
|
|
16
|
-
<div className="answer">{output.answer}</div>
|
|
17
|
-
</div>
|
|
18
|
-
</div>
|
|
19
|
-
);
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
export default Magic8Ball;
|
|
23
|
-
|
|
24
|
-
mountWidget(<Magic8Ball />);
|