xmcp TypeScript Starter

npx create-xmcp-app --example typescript

pnpm install
pnpm dev

├── src/
│   ├── tools/
│   │   └── greet.ts              # Example tool
│   ├── prompts/
│   │   └── review-code.ts        # Example prompt
│   └── resources/
│       ├── (config)/app.ts       # Static resource
│       └── (users)/[userId]/     # Dynamic resource with URI params
│           └── index.ts
├── xmcp.config.ts                # Server configuration
├── package.json
└── tsconfig.json

import { z } from "zod";
import { type InferSchema, type ToolMetadata } from "xmcp";

export const schema = {
  name: z.string().describe("The name of the user to greet"),
};

export const metadata: ToolMetadata = {
  name: "greet",
  description: "Greet the user",
  annotations: {
    title: "Greet the user",
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
  },
};

export default function greet({ name }: InferSchema<typeof schema>) {
  return `Hello, ${name}!`;
}

import { z } from "zod";
import { type InferSchema, type PromptMetadata } from "xmcp";

export const schema = {
  code: z.string().describe("The code to review"),
};

export const metadata: PromptMetadata = {
  name: "review-code",
  title: "Review Code",
  description: "Review code for best practices and potential issues",
  role: "user",
};

export default function reviewCode({ code }: InferSchema<typeof schema>) {
  return `Please review this code: ${code}`;
}

import { z } from "zod";
import { type ResourceMetadata, type InferSchema } from "xmcp";

export const schema = {
  userId: z.string().describe("The ID of the user"),
};

export const metadata: ResourceMetadata = {
  name: "user-profile",
  title: "User Profile",
  description: "User profile information",
};

export default function handler({ userId }: InferSchema<typeof schema>) {
  return `Profile data for user ${userId}`;
}

pnpm build

# HTTP transport
node dist/http.js

# STDIO transport
node dist/stdio.js