Skills mcp-builder
🛠️

mcp-builder

Safe ⚡ Contains scripts

Build MCP Servers for Claude Integration

Also available from: 92Bilal26,92Bilal26,ArtemisAI,ZhanlinCui,AutumnsGrove,Azeem-2,Doyajin174,DYAI2025,YYH211,Cam10001110101,mcp-use,ComposioHQ,davila7

Creating MCP servers requires understanding protocol design, tool patterns, and testing strategies. This guide provides step-by-step instructions for building production-ready MCP servers in Python or TypeScript that integrate seamlessly with Claude and other LLM platforms.

Supports: Claude Codex Code(CC)
🥉 73 Bronze
1

Download the skill ZIP

2

Upload in Claude

Go to Settings → Capabilities → Skills → Upload skill

3

Toggle on and start using

Test it

Using "mcp-builder". Create a Python MCP server for a GitHub API with repository search and issue tracking tools

Expected outcome:

  • • Tool: github_search_repositories - Searches repos with query, limit, and sort parameters
  • • Tool: github_get_issue - Fetches issue details with owner, repo, and issue number
  • • Input validation: Pydantic models with Field descriptions and regex constraints
  • • Error handling: Sanitized messages that help without exposing internals
  • • Pagination: Returns has_more flag and next_offset for large result sets

Using "mcp-builder". Build a TypeScript MCP server that connects to a PostgreSQL database

Expected outcome:

  • • Transport: Streamable HTTP for remote client connections
  • • Tool: database_query - Executes read-only SQL with parameter validation
  • • Security: DNS rebinding protection, connection pooling, query timeouts
  • • Response: JSON for programmatic use, Markdown for human readability
  • • Testing: stdio transport for local development, HTTP for production

Security Audit

Safe
v4 • 1/17/2026

Official Anthropic skill containing documentation and evaluation harness for MCP server development. The skill provides guidance only and contains no harmful code patterns. Subprocess execution in evaluation scripts is explicitly for testing MCP servers via stdio transport and is well-documented as part of the evaluation workflow.

11
Files scanned
3,768
Lines analyzed
1
findings
4
Total audits
Audited by: claude View Audit History →

Quality Score

45
Architecture
100
Maintainability
87
Content
30
Community
100
Security
91
Spec Compliance

What You Can Build

Integrate External APIs

Transform any REST API into an MCP server that Claude can call natively with proper authentication and error handling.

Build Custom Tools

Create specialized MCP servers exposing internal company tools and services to Claude with enterprise security controls.

Test MCP Quality

Evaluate MCP server effectiveness using the automated harness to measure tool accuracy and response quality.

Try These Prompts

New MCP Server
Help me create a new MCP server in Python using FastMCP for a weather API. Include proper tool design, input validation with Pydantic, and error handling.
Add Authentication
Add OAuth 2.1 authentication to my TypeScript MCP server. Show me how to handle authorization headers securely and protect against common attacks.
Improve Tool Design
Review my current MCP server tools and improve the naming conventions, descriptions, and input schemas following MCP best practices.
Create Evaluation
Create a comprehensive evaluation file with test questions for my MCP server. Include edge cases and multi-step tasks that test real-world usage.

Best Practices

  • Name tools with consistent prefixes matching the service name, like weather_get_forecast rather than get_weather
  • Validate all inputs using Zod (TypeScript) or Pydantic (Python) with descriptive error messages
  • Test MCP servers with the evaluation harness before deployment to ensure reliable tool behavior

Avoid

  • Avoid generic tool names like query or fetch that do not indicate the target service or resource
  • Do not return raw internal error messages that could expose implementation details to users
  • Avoid tools that perform multiple unrelated operations in a single call

Frequently Asked Questions

What programming languages are supported?
Python with FastMCP and TypeScript with the MCP SDK. Both provide similar capabilities with language-specific patterns.
How do I test my MCP server?
Use the MCP Inspector for manual testing and the evaluation harness for automated quality assessment with LLM agents.
What transport should I choose?
Use stdio for local integrations and CLI tools. Choose Streamable HTTP for remote servers with multiple clients.
How do I handle authentication?
Use OAuth 2.1 patterns for user authentication or API keys passed via authorization headers with proper scoping.
Can this skill generate an MCP server for me?
No. This skill provides guidance, templates, and best practices. You will write the implementation code based on the patterns shown.
Is this skill compatible with Claude Code?
Yes. MCP servers built with this guide can be used with Claude, Claude Code, and other MCP-compatible clients.

Developer Details

Author

anthropics

License

Complete terms in LICENSE.txt

Ref

main