@raeseoklee/mcp-workbench-demo-server 0.1.0

package/README.md

@@ -0,0 +1,47 @@
+# @raeseoklee/mcp-workbench-demo-server
+
+A ready-to-use demo [MCP](https://modelcontextprotocol.io) server for **[MCP Workbench](https://github.com/raeseoklee/mcp-workbench)**.
+
+Exposes sample tools, resources, and prompts — perfect for trying out MCP Workbench without writing any server code.
+
+## Install
+
+```bash
+npm install -g @raeseoklee/mcp-workbench-demo-server
+```
+
+## Usage
+
+```bash
+# Start the demo server (stdio transport)
+mcp-workbench-demo
+
+# Inspect with MCP Workbench
+npm install -g @raeseoklee/mcp-workbench
+mcp-workbench inspect --command mcp-workbench-demo
+
+# Run the example test suite
+mcp-workbench run examples/fixtures/demo-server.yaml --verbose
+```
+
+## What's included
+
+| Capability | Examples |
+|------------|----------|
+| **Tools** | `get_weather` — returns weather for a city |
+| **Resources** | Note resources with text content |
+| **Prompts** | Greeting prompt with customizable name |
+
+## Built with
+
+- [@modelcontextprotocol/sdk](https://www.npmjs.com/package/@modelcontextprotocol/sdk)
+- MCP spec version `2025-11-25`
+
+## Links
+
+- [MCP Workbench](https://github.com/raeseoklee/mcp-workbench) — the testing platform
+- [Example test specs](https://github.com/raeseoklee/mcp-workbench/tree/develop/examples/fixtures)
+
+## License
+
+[Apache-2.0](https://github.com/raeseoklee/mcp-workbench/blob/develop/LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,189 @@
+/**
+ * Demo MCP server using the official @modelcontextprotocol/sdk.
+ * Provides a simple weather tool, a note resource, and a greeting prompt —
+ * just enough to exercise all of MCP Workbench's features.
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+const CITIES = {
+    Seoul: { temp: 18, condition: "Partly cloudy" },
+    Tokyo: { temp: 22, condition: "Sunny" },
+    London: { temp: 12, condition: "Rainy" },
+    New_York: { temp: 20, condition: "Clear" },
+};
+const NOTES = {
+    "note://welcome": "Welcome to MCP Workbench! This is a demo note resource.",
+    "note://readme": "# Demo Server\n\nThis server is part of the MCP Workbench examples.",
+};
+const server = new Server({ name: "demo-mcp-server", version: "0.1.0" }, {
+    capabilities: {
+        tools: { listChanged: false },
+        resources: { subscribe: false, listChanged: false },
+        prompts: { listChanged: false },
+    },
+});
+// ─── Tool: list-roots (exercises client roots capability) ────────────────────
+// This tool asks the client for its roots list, then returns them as text.
+// It demonstrates the server→client roots/list call pattern.
+// ─── Tools ───────────────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "list_roots",
+            description: "Ask the client for its workspace roots (exercises roots capability)",
+            inputSchema: { type: "object", properties: {} },
+            annotations: { readOnlyHint: true, title: "List Roots" },
+        },
+        {
+            name: "get_weather",
+            description: "Get current weather for a city",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    city: {
+                        type: "string",
+                        description: "City name (Seoul, Tokyo, London, New_York)",
+                    },
+                },
+                required: ["city"],
+            },
+            annotations: {
+                readOnlyHint: true,
+                title: "Get Weather",
+            },
+        },
+        {
+            name: "create_note",
+            description: "Create a new note (destructive example)",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    id: { type: "string" },
+                    content: { type: "string" },
+                },
+                required: ["id", "content"],
+            },
+            annotations: {
+                destructiveHint: true,
+                title: "Create Note",
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
+    const { name, arguments: args = {} } = request.params;
+    if (name === "list_roots") {
+        try {
+            // Ask the client for its roots via the session
+            const result = await extra.sendRequest({ method: "roots/list", params: {} }, 
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            {});
+            const lines = result.roots.map((r) => `${r.uri}${r.name ? ` (${r.name})` : ""}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: lines.length ? `Roots:\n${lines.join("\n")}` : "No roots provided by client",
+                    }],
+            };
+        }
+        catch {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "Client does not support roots/list" }],
+            };
+        }
+    }
+    if (name === "get_weather") {
+        const city = args["city"];
+        if (!city || typeof city !== "string") {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "Error: city must be a string" }],
+            };
+        }
+        const weather = CITIES[city];
+        if (!weather) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: unknown city "${city}". Known cities: ${Object.keys(CITIES).join(", ")}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Weather in ${city}: ${weather.temp}°C, ${weather.condition}`,
+                },
+            ],
+        };
+    }
+    if (name === "create_note") {
+        const id = args["id"];
+        const content = args["content"];
+        NOTES[`note://${id}`] = content;
+        return {
+            content: [{ type: "text", text: `Note created: note://${id}` }],
+        };
+    }
+    return {
+        isError: true,
+        content: [{ type: "text", text: `Unknown tool: ${name}` }],
+    };
+});
+// ─── Resources ───────────────────────────────────────────────────────────────
+server.setRequestHandler(ListResourcesRequestSchema, async () => ({
+    resources: Object.keys(NOTES).map((uri) => ({
+        uri,
+        name: uri.replace("note://", ""),
+        mimeType: "text/plain",
+    })),
+}));
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const { uri } = request.params;
+    const content = NOTES[uri];
+    if (!content) {
+        throw new Error(`Resource not found: ${uri}`);
+    }
+    return {
+        contents: [{ uri, mimeType: "text/plain", text: content }],
+    };
+});
+// ─── Prompts ─────────────────────────────────────────────────────────────────
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: [
+        {
+            name: "greet",
+            description: "Generate a greeting message",
+            arguments: [
+                { name: "name", description: "Person to greet", required: true },
+                { name: "style", description: "formal | casual", required: false },
+            ],
+        },
+    ],
+}));
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+    if (name !== "greet")
+        throw new Error(`Unknown prompt: ${name}`);
+    const personName = args["name"] ?? "World";
+    const style = args["style"] ?? "casual";
+    const greeting = style === "formal"
+        ? `Good day, ${personName}. How may I assist you?`
+        : `Hey ${personName}! What's up?`;
+    return {
+        description: "A greeting message",
+        messages: [
+            { role: "user", content: { type: "text", text: greeting } },
+        ],
+    };
+});
+// ─── Start ───────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@raeseoklee/mcp-workbench-demo-server",
+  "version": "0.1.0",
+  "description": "Demo MCP server for MCP Workbench — tools, resources, and prompts out of the box",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/raeseoklee/mcp-workbench.git"
+  },
+  "homepage": "https://github.com/raeseoklee/mcp-workbench#readme",
+  "bugs": {
+    "url": "https://github.com/raeseoklee/mcp-workbench/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "mcp-server",
+    "demo",
+    "example",
+    "mcp-workbench"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.js",
+  "bin": {
+    "mcp-workbench-demo": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}