chore: release 0.3.0 (#204)
* chore: bump version to 0.3.0 Breaking changes: - `viewport` replaced with `containerDimensions` in host context New examples: - video-resource-server - sheet-music-server 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * fix(video-resource-server): add missing server-utils and fix import path The video-resource-server was importing from a non-existent ../shared/server-utils.js path. Added the server-utils.ts file and fixed the import to use ./src/server-utils.js like other examples. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com> * chore: update ext-apps version refs to 0.3.0 --------- Co-authored-by: Claude <noreply@anthropic.com>
This commit is contained in:
Olivier Chafik
GitHub
parent
7eb98ad121
commit
ecc593bcec
16 changed files with 207 additions and 33 deletions
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"preact": "^10.0.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"react": "^19.2.0",
|
||||
"react-dom": "^19.2.0",
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"solid-js": "^1.9.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"svelte": "^5.0.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"zod": "^4.1.13"
|
||||
},
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"vue": "^3.5.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"chart.js": "^4.4.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"react": "^19.2.0",
|
||||
"react-dom": "^19.2.0",
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"chart.js": "^4.4.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"chart.js": "^4.4.0",
|
||||
"react": "^19.2.0",
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"abcjs": "^6.4.4",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"chart.js": "^4.4.0",
|
||||
"systeminformation": "^5.27.11",
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"react": "^19.2.0",
|
||||
"react-dom": "^19.2.0",
|
||||
|
|
|
|||
|
|
@ -24,7 +24,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"zod": "^4.1.13"
|
||||
},
|
||||
|
|
|
|||
110
examples/video-resource-server/src/server-utils.ts
Normal file
110
examples/video-resource-server/src/server-utils.ts
Normal file
|
|
@ -0,0 +1,110 @@
|
|||
/**
|
||||
* Shared utilities for running MCP servers with various transports.
|
||||
*/
|
||||
|
||||
import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
|
||||
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
||||
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
|
||||
import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
|
||||
import cors from "cors";
|
||||
import type { Request, Response } from "express";
|
||||
|
||||
/**
|
||||
* Starts an MCP server using the appropriate transport based on command-line arguments.
|
||||
*
|
||||
* If `--stdio` is passed, uses stdio transport. Otherwise, uses Streamable HTTP transport.
|
||||
*
|
||||
* @param createServer - Factory function that creates a new McpServer instance.
|
||||
*/
|
||||
export async function startServer(
|
||||
createServer: () => McpServer,
|
||||
): Promise<void> {
|
||||
try {
|
||||
if (process.argv.includes("--stdio")) {
|
||||
await startStdioServer(createServer);
|
||||
} else {
|
||||
await startStreamableHttpServer(createServer);
|
||||
}
|
||||
} catch (e) {
|
||||
console.error(e);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Starts an MCP server with stdio transport.
|
||||
*
|
||||
* @param createServer - Factory function that creates a new McpServer instance.
|
||||
*/
|
||||
export async function startStdioServer(
|
||||
createServer: () => McpServer,
|
||||
): Promise<void> {
|
||||
await createServer().connect(new StdioServerTransport());
|
||||
}
|
||||
|
||||
/**
|
||||
* Starts an MCP server with Streamable HTTP transport in stateless mode.
|
||||
*
|
||||
* Each request creates a fresh server and transport instance, which are
|
||||
* closed when the response ends (no session tracking).
|
||||
*
|
||||
* The server listens on the port specified by the PORT environment variable,
|
||||
* defaulting to 3001 if not set.
|
||||
*
|
||||
* @param createServer - Factory function that creates a new McpServer instance per request.
|
||||
*/
|
||||
export async function startStreamableHttpServer(
|
||||
createServer: () => McpServer,
|
||||
): Promise<void> {
|
||||
const port = parseInt(process.env.PORT ?? "3001", 10);
|
||||
|
||||
// Express app - bind to all interfaces for development/testing
|
||||
const expressApp = createMcpExpressApp({ host: "0.0.0.0" });
|
||||
expressApp.use(cors());
|
||||
|
||||
expressApp.all("/mcp", async (req: Request, res: Response) => {
|
||||
// Create fresh server and transport for each request (stateless mode)
|
||||
const server = createServer();
|
||||
const transport = new StreamableHTTPServerTransport({
|
||||
sessionIdGenerator: undefined,
|
||||
});
|
||||
|
||||
// Clean up when response ends
|
||||
res.on("close", () => {
|
||||
transport.close().catch(() => {});
|
||||
server.close().catch(() => {});
|
||||
});
|
||||
|
||||
try {
|
||||
await server.connect(transport);
|
||||
await transport.handleRequest(req, res, req.body);
|
||||
} catch (error) {
|
||||
console.error("MCP error:", error);
|
||||
if (!res.headersSent) {
|
||||
res.status(500).json({
|
||||
jsonrpc: "2.0",
|
||||
error: { code: -32603, message: "Internal server error" },
|
||||
id: null,
|
||||
});
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
const { promise, resolve, reject } = Promise.withResolvers<void>();
|
||||
|
||||
const httpServer = expressApp.listen(port, (err?: Error) => {
|
||||
if (err) return reject(err);
|
||||
console.log(`Server listening on http://localhost:${port}/mcp`);
|
||||
resolve();
|
||||
});
|
||||
|
||||
const shutdown = () => {
|
||||
console.log("\nShutting down...");
|
||||
httpServer.close(() => process.exit(0));
|
||||
};
|
||||
|
||||
process.on("SIGINT", shutdown);
|
||||
process.on("SIGTERM", shutdown);
|
||||
|
||||
return promise;
|
||||
}
|
||||
|
|
@ -27,7 +27,7 @@
|
|||
"prepublishOnly": "npm run build"
|
||||
},
|
||||
"dependencies": {
|
||||
"@modelcontextprotocol/ext-apps": "^0.2.2",
|
||||
"@modelcontextprotocol/ext-apps": "^0.3.0",
|
||||
"@modelcontextprotocol/sdk": "^1.24.0",
|
||||
"cheerio": "^1.0.0",
|
||||
"zod": "^4.1.13"
|
||||
|
|
|
|||
Loading…
Reference in a new issue