refactor: rename standalone server example to simple and update dependencies

- Changed the directory name from `standalone` to `simple` in the workspace configuration.
- Updated dependencies in `pnpm-lock.yaml`, including removing `@types/bun` and adjusting TypeScript version.
- Modified CLI to use `stdio: 'inherit'` for better output handling.
- Enhanced resource definition in `mcp-server.ts` to include metadata fields.
- Updated resource definition interface in `types.ts` to improve documentation and structure.

Author: tonxxd

packages/cli/src/index.ts

@@ -155,25 +155,11 @@ program
       // 3. Server with tsx
       const serverProc = spawn('npx', ['tsx', 'watch', serverFile], {
         cwd: projectPath,
-        stdio: 'pipe',
+        stdio: 'inherit',
         shell: false,
         env: { ...process.env, PORT: String(port) },
       });
 
-      // Handle server errors gracefully
-      serverProc.stderr?.on('data', (data) => {
-        const output = data.toString();
-        if (output.includes('EADDRINUSE')) {
-          console.log(`\x1b[31m✗\x1b[0m Port ${port} is still in use. Please try a different port with --port`);
-          console.log(`\x1b[90mHint: Use --port 3001 or kill the process using port ${port}\x1b[0m`);
-          process.exit(1);
-        }
-      });
-      
-      serverProc.stdout?.on('data', (data) => {
-        process.stdout.write(data);
-      });
-      
       processes.push(serverProc);
 
       // Auto-open inspector if enabled

packages/mcp-use/examples/server/simple/README.md

@@ -0,0 +1,65 @@
+# Simple MCP Server Example
+
+A minimal example of an MCP server with a single "hello world" tool.
+
+## Features
+
+- Single `hello-world` tool that returns "Hello World!"
+- MCP Inspector integration
+- TypeScript support
+- Simple and easy to understand
+
+## Getting Started
+
+### Development
+
+```bash
+# Install dependencies
+yarn install
+
+# Start development server
+yarn dev
+```
+
+This will start:
+- MCP server on port 3000
+- MCP Inspector at http://localhost:3000/inspector
+
+### Production
+
+```bash
+# Build the server
+yarn build
+
+# Run the built server
+yarn start
+```
+
+## Usage
+
+The server provides one tool:
+
+- `hello-world` - Returns "Hello World!" message
+
+## Project Structure
+
+```
+simple-example/
+├── src/
+│   └── server.ts              # MCP server with hello world tool
+├── dist/                      # Built files
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## API Reference
+
+### MCP Tools
+
+- `hello-world` - A simple tool that returns hello world
+
+## Learn More
+
+- [MCP Documentation](https://modelcontextprotocol.io)
+- [mcp-use Documentation](https://docs.mcp-use.io)

…/examples/server/standalone/package.json …-use/examples/server/simple/package.jsonpackages/mcp-use/examples/server/standalone/package.json renamed to packages/mcp-use/examples/server/simple/package.json packages/mcp-use/examples/server/standalone/package.json renamed to packages/mcp-use/examples/server/simple/package.json

@@ -1,8 +1,16 @@
 {
-  "name": "standalone-mcp-example",
+  "name": "simple-example",
   "type": "module",
   "version": "1.0.0",
-  "description": "Standalone MCP server example",
+  "description": "Simple MCP server example with hello world tool",
+  "author": "",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "server",
+    "example",
+    "hello-world"
+  ],
   "main": "dist/server.js",
   "scripts": {
     "build": "mcp-use build",
@@ -14,8 +22,8 @@
   },
   "devDependencies": {
     "@mcp-use/cli": "workspace:*",
-    "@mcp-use/inspector": "workspace:*",
-    "@types/bun": "latest",
-    "typescript": "^5.3.3"
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.0.0"
   }
-}
+}

packages/mcp-use/examples/server/simple/src/server.ts

@@ -0,0 +1,51 @@
+import { createMCPServer } from 'mcp-use'
+
+// Create an MCP server (which is also an Express app)
+// The MCP Inspector is automatically mounted at /inspector
+const server = createMCPServer('simple-example-server', {
+  version: '1.0.0',
+  description: 'A simple MCP server example',
+})
+
+console.log('Server type:', typeof server)
+console.log('Server has tool method:', 'tool' in server)
+console.log('Server tool method:', typeof server.tool)
+console.log('Server keys:', Object.keys(server))
+console.log('Server prototype:', Object.getOwnPropertyNames(Object.getPrototypeOf(server)))
+
+
+const PORT = process.env.PORT || 3000
+
+// Simple tool that returns hello world
+server.tool({
+  name: 'hello-world',
+  description: 'A simple tool that returns hello world',
+  inputs: [],
+  fn: async () => {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: 'Hello World!'
+        }
+      ]
+    }
+  },
+})
+
+server.resource({
+  name: 'test',
+  uri: 'resource://test',
+  mimeType: 'text/plain',
+  description: 'A test resource',
+  fn: async () => {
+    return 'ciao'
+  }
+})
+
+// Start the server (MCP endpoints auto-mounted at /mcp)
+server.listen(PORT, () => {
+  console.log(`🚀 Simple Example Server running on port ${PORT}`)
+  console.log(`📊 Inspector available at http://localhost:${PORT}/inspector`)
+  console.log(`🔧 MCP endpoint at http://localhost:${PORT}/mcp`)
+})

packages/mcp-use/examples/server/simple/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "allowJs": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

packages/mcp-use/src/server/mcp-server.ts

@@ -95,7 +95,7 @@ export class McpServer {
     this.server.resource(
       resourceDefinition.name,
       resourceDefinition.uri,
-      resourceDefinition.resource,
+      {mimeType: resourceDefinition.mimeType, description: resourceDefinition.description},
       async () => {
         return await resourceDefinition.fn()
       },

packages/mcp-use/src/server/types.ts

@@ -22,13 +22,18 @@ export interface ResourceTemplateDefinition {
 }
 
 export interface ResourceDefinition {
+  /** Unique identifier for the resource */
   name: string
+  /** URI pattern for accessing the resource (e.g., 'config://app-settings') */
   uri: string
-  resource: {
-    title?: string
-    description?: string
-    mimeType: string
-  }
+  /** Resource metadata including MIME type and description */
+  /** Optional title for the resource */
+  title?: string
+  /** Optional description of the resource */
+  description?: string
+  /** MIME type of the resource content (required) */
+  mimeType: string
+  /** Async function that returns the resource content */
   fn: ResourceHandler
 }
 

pnpm-lock.yaml

@@ -1,5 +1,5 @@
 packages:
   - 'packages/*'
   - 'packages/mcp-use/examples/client/react'
-  - 'packages/mcp-use/examples/server/standalone'
+  - 'packages/mcp-use/examples/server/simple'
   - 'test_app'