Command Code

MCP Builder

Guides creation of high-quality MCP (Model Context Protocol) servers for integrating external APIs and services with LLMs using Python or TypeScript.

Download this Skill

npx degit LangbaseInc/agent-skills/mcp-builder my-mcp-builder

Overview

Build MCP servers that expose external tools, resources, and APIs to Claude and other LLMs through the Model Context Protocol standard.

Key Features

  • Server Scaffolding - Generate MCP server structure
  • Tool Integration - Expose APIs as LLM-callable tools
  • Resource Management - Provide file and data resources
  • Schema Definition - Define tool parameters and validation
  • Error Handling - Robust error handling patterns
  • Testing - Test MCP servers with Claude

Supported Languages

Python

  • Uses mcp Python package
  • Type hints for tool definitions
  • Async/await support

TypeScript

  • Uses @modelcontextprotocol/sdk
  • Full TypeScript type safety
  • Modern async patterns

MCP Server Components

Tools

Expose functions that Claude can call:

  • Function definition and parameters
  • Input validation
  • Return value formatting

Resources

Provide data and files:

  • File reading
  • API data fetching
  • Database queries

Prompts

Pre-defined prompt templates:

  • Reusable prompts
  • Parameter substitution
  • Context injection

Development Workflow

  1. Plan Server - Define tools and resources
  2. Scaffold - Generate server structure
  3. Implement Tools - Add tool logic
  4. Test Locally - Validate with Claude Code
  5. Deploy - Package and distribute

Best Practices

  • Define clear tool schemas
  • Validate inputs thoroughly
  • Handle errors gracefully
  • Document tool usage
  • Test with real LLM calls
  • Version your server
  • Provide examples

Use Cases

  • API integration (GitHub, Stripe, etc.)
  • Database access
  • File system operations
  • Custom business logic
  • Third-party service integration
  • Data transformation tools