mcp-builder
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
Installation
Pick a client and clone the repository into its skills directory.
Installation
About this skill
Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).
How to use
Zapoznaj się z podstawami MCP, czytając dokumentację Model Context Protocol — zrozum, jak serwery MCP umożliwiają modelom językowymi dostęp do zewnętrznych usług poprzez dobrze zaprojektowane narzędzia.
Przeanalizuj API lub usługę, którą chcesz zintegrować. Zdecyduj, czy chcesz zapewnić pełne pokrycie punktów końcowych API, czy skupić się na specjalistycznych narzędziach workflow dla konkretnych zadań — pełne pokrycie daje agentom większą elastyczność.
Zaprojektuj nazwy narzędzi używając spójnych prefiksów (np. github_create_issue, github_list_repos) i sformułowań zorientowanych na działania. Upewnij się, że nazwy są jasne i ułatwiają agentom szybkie znalezienie odpowiednich narzędzi.
Napisz zwięzłe opisy narzędzi i zaplanuj filtrowanie oraz paginację wyników, aby narzędzia zwracały skoncentrowane, istotne dane. Jeśli klient obsługuje wykonywanie kodu, agenty będą mogły efektywnie przetwarzać dane.
Zaimplementuj serwer MCP w wybranym języku — użyj FastMCP dla Pythona lub MCP SDK dla Node/TypeScript — postępując zgodnie z wytycznymi protokołu dla struktury narzędzi i parametrów.
Przetestuj komunikaty błędów, aby były konkretne i pomocne — powinny zawierać sugestie i następne kroki, które będą kierować agentami ku rozwiązaniom zamiast pozostawiać ich w niepewności.