Quickstart Guide

import { createMcpServer } from 'mcponce';

// 1. Initialize the MCP application
const app = createMcpServer({
  name: 'my-assistant',
  version: '1.0.0',
  port: 8080 // optional: defaults to 3000 or dynamic open port
});

// 2. Define your first tool with shorthand schema
app.tool({
  name: 'greet_user',
  description: 'Returns a friendly greeting with user status',
  inputSchema: {
    username: 'string',
    vip: { type: 'boolean', default: false }
  },
  handler: ({ username, vip }) => {
    return {
      message: `Hello ${vip ? 'VIP member' : ''} ${username}! Welcome back.`,
      timestamp: new Date().toISOString()
    };
  }
});

// 3. Define a mathematical calculation tool with caching
app.tool({
  name: 'fibonacci',
  description: 'Calculates the Nth Fibonacci number with in-memory caching',
  inputSchema: {
    n: { type: 'number', default: 10 }
  },
  cache: { ttlMs: 60_000 },
  handler: ({ n }) => {
    function fib(num: number): number {
      if (num <= 1) return num;
      let a = 0, b = 1;
      for (let i = 2; i <= num; i++) {
        const c = a + b;
        a = b;
        b = c;
      }
      return b;
    }
    return { n, result: fib(n) };
  }
});

// 4. Run the server
app.run();

# Automatically configures both Claude Desktop and Cursor!
node server.js install

{
  "mcpServers": {
    "my-assistant": {
      "command": "node",
      "args": ["/absolute/path/to/server.js", "--background"]
    }
  }
}

# List all registered tools and parameter signatures:
npx mcponce call --list

# Call greet_user:
npx mcponce call greet_user --username=Ahmet --vip=true

# Call fibonacci with JSON output:
npx mcponce call fibonacci --n 20 --json