Mcp Builder
This walks you through building MCP servers that let LLMs interact with external APIs, covering both TypeScript and Python implementations. It's opinionated about design choices: favor comprehensive API coverage over workflow shortcuts, use TypeScript with streamable HTTP for remote servers, and prioritize clear tool naming with consistent prefixes. The guide includes four phases from research through evaluation, with specific sections on studying the MCP spec, setting up error handling, and creating test questions that verify your server actually works. The evaluation section is notably detailed, requiring you to create ten complex, read-only questions with verifiable answers. Use this when you're integrating a third-party service and want to avoid common pitfalls around tool design and agent discoverability.
- GitHub stars
- 460
- last updated
- Jun 7, 2026
Install
$ npx -y skills add malob/nix-config --skill mcp-builder --agent claude-codeInstalls into .claude/skills of the current project.
Files
MCP Server Development Guide
Overview
Create MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. The quality of an MCP server is measured by how well it enables LLMs to accomplish real-world tasks.
Process
🚀 High-Level Workflow
Creating a high-quality MCP server involves four main phases:
Phase 1: Deep Research and Planning
1.1 Understand Modern MCP Design
API Coverage vs. Workflow Tools: Balance comprehensive API endpoint coverage with specialized workflow tools. Workflow tools can be more convenient for specific tasks, while comprehensive coverage gives agents flexibility to compose operations. Performance varies by client—some clients benefit from code execution that combines basic tools, while others work better with higher-level workflows. When uncertain, prioritize comprehensive API coverage.
Tool Naming and Discoverability:
Clear, descriptive tool names help agents find the right tools quickly. Use consistent prefixes (e.g., github_create_issue, github_list_repos) and action-oriented naming.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/malob/nix-config
- Categories
- Documentation, Code Review & Quality, AI & Agent Building, Python
- License
- MIT
- First seen
- Jun 11, 2026
More from malob/nix-config
All 14Recommended
More Documentation
create-analyzermc-zuri/mineflayer-bedrockCreate a new packet analyzer for Minecraft Bedrock logs. Generates template code, provides documentation links, and guides testing workflow.0skills.sh installs
implementmertbuilds/skillsBuild a feature in an isolated worktrunk worktree, commit, and open a draft PR. Use whenever the user asks to implement, build, add, or fix something that touch0skills.sh installs
Check Inline Code Formattingnextflow-io/trainingReview inline code in markdown files for proper formatting and syntax highlighting. Check for missing backticks on CLI flags, filenames, and code elements. Veri0skills.sh installs
theme-factorynicepkg/ai-workflowToolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc. There are 10 pre-set themes with colors/fo0skills.sh installswebfluencenicepkg/ai-workflowContent web architecture framework. Use when diagnosing offer doc usage, content-to-conversion pathways, or why someone isn't getting sales despite traffic.0skills.sh installs
toxynissl-lab/toxyIf you're building .NET apps that need to pull text or data out of Office docs, PDFs, emails, or EPUBs, this handles the parsing so you...0skills.sh installs