How does this skill handle MCP tool errors?

The skill enforces a pattern where tools never throw errors, as throwing breaks the connection. Instead, tools return an object containing the error message and an isError: true flag, allowing the client to handle the issue gracefully.

What is the benefit of using Zod .describe() in MCP?

Using .describe() on your Zod schemas provides human-readable documentation that is automatically surfaced in the MCP inspector, making it easier for users and AI models to understand tool parameters.

Why shouldn't I use console.log in MCP servers?

In MCP development, console.log outputs directly to stdout, which can interfere with the stdio transport protocol and cause connection failures. You should use getLogger(mcp) to properly route notifications through the MCP protocol.

Does this support both local and remote MCP deployments?

Yes, it includes architectural patterns for both Stdio transport (local development) and HTTP transport using SSE and Bearer token authentication (remote deployment).

MCP Development Patterns

Name: MCP Development Patterns
Author: youdotcom-oss

byyoudotcom-oss

•

API開発

Standardizes Model Context Protocol (MCP) server development with robust Zod schemas, error handling, and specialized testing strategies.

概要

The MCP Development Patterns skill provides a comprehensive framework for building high-quality Model Context Protocol servers, specifically optimized for the You.com ecosystem. It guides developers through implementing domain-specific best practices such as descriptive Zod schema design for better discovery, protocol-safe error handling that prevents client disconnects, and structured logging. By enforcing consistent response formats and providing strategies for both local stdio and remote HTTP deployments, this skill ensures that MCP tools are reliable, maintainable, and easy to debug using interactive inspectors.

主な機能

Protocol-compliant error handling to maintain stable client-server connections
Advanced testing strategies for shared and dedicated MCP clients
Standardized response formats for both human and programmatic consumption
7 GitHub stars
Structured logging via getLogger to prevent stdout interference
Zod schema design with auto-documentation for MCP inspectors

ユースケース

Debugging transport-specific issues between Stdio and HTTP environments
Implementing custom MCP tools with complex validation requirements
Developing or contributing to the @youdotcom-oss/mcp package

概要

主な機能

Protocol-compliant error handling to maintain stable client-server connections
Advanced testing strategies for shared and dedicated MCP clients
Standardized response formats for both human and programmatic consumption
7 GitHub stars
Structured logging via getLogger to prevent stdout interference
Zod schema design with auto-documentation for MCP inspectors

ユースケース

Debugging transport-specific issues between Stdio and HTTP environments
Implementing custom MCP tools with complex validation requirements
Developing or contributing to the @youdotcom-oss/mcp package