skills.rest
dformoso
dformosoCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

design-mcp-server

Design and document MCP server configurations with YAML frontmatter.

Updated Apr 28, 2026
Search Tags:#version control#software architecture#configuration management#protocol design#MCP server design
One-click install
npx skills add https://github.com/dformoso/positronic --skill design-mcp-server-dformoso
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: design-mcp-server
Source: https://github.com/dformoso/positronic/tree/main/skills/defining/design-mcp-server
Command: npx skills add https://github.com/dformoso/positronic --skill design-mcp-server-dformoso

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the design and documentation process for a Model Context Protocol (MCP) server, ensuring that all design decisions are captured in a versioned artifact for future reference and development.

Core Features & Use Cases

  • Design Decision Documentation: Captures design decisions for transport, authentication, tool surface, state management, capability declaration, testing, and observability.
  • Versioned Artifacts: Generates a versioned definitions/mcp-servers/ artifact that can be read by other systems.
  • Amend Mode: Supports scoped changes to existing designs without starting from scratch.

Quick Start

Use the design-mcp-server skill to start designing a new MCP server.

Frequently Asked Questions about design-mcp-server

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I design and document a Model Context Protocol server configuration?▼

To design an MCP server, you need to document decisions for transport, authentication, tool surface, state management, capability declaration, testing, and observability. This process generates a versioned artifact for future development.

What is the best way to manage configuration changes for an existing MCP server?▼

Managing MCP server configuration changes is best handled using an amend mode, which supports scoped modifications to existing designs without requiring you to start the documentation process from scratch.

How does version control work for MCP server design artifacts?▼

Version control for MCP server artifacts is managed by generating a versioned definitions/mcp-servers/ file using YAML frontmatter, ensuring structured configuration management and readability by other systems.

Can I use YAML frontmatter for structured MCP server configuration management?▼

Yes, YAML frontmatter is utilized for structured configuration management, allowing you to capture design decisions and output a versioned artifact that other downstream systems can easily read.

What should be documented when defining an MCP server tool surface?▼

When defining an MCP server tool surface, you should document the design decisions for transport, authentication, state management, capability declaration, testing, and observability to ensure complete configuration coverage.

Does this approach support scoped modifications to existing protocol designs?▼

Yes, the amend mode supports scoped changes to existing protocol designs, allowing targeted updates to transport, authentication, and tool surface configurations while preserving the original versioned artifact.

Related Skills

Explore More Software Engineering Skills→
Fr-e-dFr-e-d
157

architecture-extract

Analyze project directory structures to generate architectural summaries.

Community
Basic
aeonbridgeaeonbridge

mcp

Build MCP servers and clients with Python or TypeScript SDKs.

Official
Intermediate
jerelvelardejerelvelarde
41

copilotkit-agui

Implement the AG-UI protocol for agent-frontend communication via SSE transport.

Community
Advanced
dieu-donneedieu-donnee

spec-miner

Reverse-engineer codebases into formal EARS specification artifacts.

Community
Advanced