Agent skill · software engineering · borghei
mcp-server-builder
Build MCP (Model Context Protocol) servers with tool definitions, resource providers, prompt templates, and transports. Use when exposing APIs to AI agents, building tool servers, converting OpenAPI to MCP, or creating MCP integrations.
Why this skill is useful
Adds executable scripts for OpenAPI-to-MCP conversion and server implementations in TypeScript and Python, which are not commonly found in public documentation.
What it needs
Requires docker installed locally. About 4k tokens when loaded. Last updated 2026-07-21. 462 stars on the source repository.
What this skill does
MCP Server Builder Tier: POWERFUL Category: Engineering / AI Integration Maintainer: Claude Skills Team Overview Design and ship production-ready MCP (Model Context Protocol) servers from API contracts. Covers tool definition best practices, resource providers, prompt templates, OpenAPI-to-MCP conversion, TypeScript and Python server implementations, transport selection (stdio, SSE, StreamableHTTP), authentication patterns, testing strategies, and deployment configurations. Treats schema quality and tool discoverability as first-class concerns. Keywords MCP, Model Context Protocol, MCP server, tool definition, resource provider, prompt template, stdio transport, SSE transport, OpenAPI to MCP, AI tool server, Claude tools Core Capabilities Tool design & schema quality — verb-noun naming, description engineering, typed input schemas, LLM-friendly output formatting Server implementation — TypeScript (@modelcontextprotocol/sdk) and Python (mcp[cli]) servers; tool/resource/prompt registration; structured error handling; logging, auth, and rate-limit middleware Transport & deployment — stdio (local/CLI), SSE (web), StreamableHTTP (production), Docker containerization, health checks, graceful shutdown Testing & validation — schema validation, MCP Inspector integration tests, contract/snapshot tests, load testing for remote servers When to Use Exposing an internal REST API to Claude, Cursor, or other MCP clients Replacing brittle browser automation with typed tool interfaces Building a shared MCP server for multiple teams and AI assistants Converting an OpenAPI spec into MCP tools automatically Creating domain-specific tool servers (database, monitoring, deployment) Clarify First Before building the server, confirm these inputs. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills borghei/mcp-server-builder