// Tool: greet - Greets a user by name
server.registerTool(
  'greet',
  {
    description: 'Greets a user by name',
    inputSchema: {
      name: z.string().describe('The name of the person to greet'),
    },
  },
  async ({ name }) => {
    return {
      content: [{ type: 'text', text: `Hello, ${name}! Welcome to the MCP server.` }],
    }
  },
)

// Tool: add - Adds two numbers together
server.registerTool(
  'add',
  {
    description: 'Adds two numbers together',
    inputSchema: {
      a: z.number().describe('First number'),
      b: z.number().describe('Second number'),
    },
  },
  async ({ a, b }) => {
    return {
      content: [{ type: 'text', text: `The sum of ${a} and ${b} is ${a + b}` }],
    }
  },
)

// Static Resource: Application configuration
server.registerResource(
  'config',
  'config://app',
  {
    description: 'Application configuration',
    mimeType: 'application/json',
  },
  async () => {
    return {
      contents: [{
        uri: 'config://app',
        mimeType: 'application/json',
        text: JSON.stringify({
          appName: 'Sample MCP',
          version: '1.0.0',
          features: ['tools', 'resources', 'prompts'],
        }, null, 2),
      }],
    }
  },
)

// Dynamic Resource: User profile with URI template
server.registerResource(
  'user-profile',
  'users://{userId}/profile',
  {
    description: 'User profile by ID',
    mimeType: 'application/json',
  },
  async (uri, extra) => {
    const { userId } = extra as unknown as { userId: string }
    // Fetch user data based on userId...
    return {
      contents: [{
        uri: uri.href,
        mimeType: 'application/json',
        text: JSON.stringify(userData, null, 2),
      }],
    }
  },
)

// Simple Prompt: No arguments required
server.registerPrompt(
  'explain-code',
  {
    description: 'Prompt for explaining code',
  },
  async () => {
    return {
      messages: [{
        role: 'user',
        content: {
          type: 'text',
          text: 'Please explain the following code in detail, including its purpose, how it works, and any potential improvements.',
        },
      }],
    }
  },
)

// Parameterized Prompt: Accepts arguments for customization
server.registerPrompt(
  'review-code',
  {
    description: 'Prompt for code review with specified focus',
    argsSchema: {
      language: z.string().describe('Programming language of the code'),
      focus: z.string().optional().describe('Focus area: security, performance, readability'),
    },
  },
  async ({ language, focus }) => {
    const focusArea = focus || 'general best practices'
    return {
      messages: [{
        role: 'user',
        content: {
          type: 'text',
          text: `Please review the following ${language} code with a focus on ${focusArea}. Provide specific suggestions for improvement.`,
        },
      }],
    }
  },
)

# Clone the repository
git clone https://github.com/your-username/sample-mcp.git
cd sample-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Start the MCP server
npm start

# Or run in development mode with auto-rebuild
npm run dev

{
  "mcpServers": {
    "sample-mcp": {
      "command": "node",
      "args": ["/path/to/sample-mcp/dist/main.js"]
    }
  }
}

sample-mcp/
├── src/
│   ├── main.ts       # Main entry point and server setup
│   ├── tools.ts      # Tool definitions (greet, add)
│   ├── resources.ts  # Resource definitions (config, user-profile)
│   └── prompts.ts    # Prompt definitions (explain-code, review-code)
├── dist/             # Compiled JavaScript output
├── package.json      # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # This file