Mcp Builder

MCP Server Builder

Build production-ready MCP servers with tools, resources, prompts, and interactive widgets using mcp-use.

Before You Code

Decompose user requests into tools, widgets, and resources. Decide what needs UI vs text.

Read [design-and-architecture.md](references/design-and-architecture.md): when planning what to build, deciding tool vs widget, or designing UX flows.

Implementation

• Tools, resources, prompts → [tools-and-resources.md](references/tools-and-resources.md): when writing server-side server.tool(), server.resource(), server.prompt() code
• Visual widgets (React TSX) → [widgets.md](references/widgets.md): when creating interactive UI widgets in resources/ folder
• Response helper API → [response-helpers.md](references/response-helpers.md): when choosing how to format tool/resource return values
• URI template patterns → [resource-templates.md](references/resource-templates.md): when defining parameterized resources

Quick Reference

import {
  MCPServer,
  text,
  object,
  markdown,
  html,
  image,
  widget,
  error,
} from "mcp-use/server";
import { z } from "zod";

const server = new MCPServer({ name: "my-server", version: "1.0.0" });

// Tool
server.tool(
  {
    name: "my-tool",
    description: "...",
    schema: z.object({ param: z.string().describe("...") }),
  },
  async ({ param }) => text("result"),
);

// Resource
server.resource(
  { uri: "config://settings", name: "Settings", mimeType: "application/json" },
  async () => object({ key: "value" }),
);

// Prompt
server.prompt(
  {
    name: "my-prompt",
    description: "...",
    schema: z.object({ topic: z.string() }),
  },
  async ({ topic }) => text(`Write about ${topic}`),
);

server.listen();

Response helpers: text(), object(), markdown(), html(), image(), audio(), binary(), error(), mix(), widget()

Server methods: server.tool(), server.resource(), server.resourceTemplate(), server.prompt(), server.listen()

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Shubhamsaboo
• Source: Shubhamsaboo/awesome-llm-apps
• License: Apache-2.0
• Homepage: https://www.theunwindai.com

Install and usage instructions live in the source repository linked above.