skills.rest
afonsoft
afonsoftCOMMUNITY
Explore all skills by this author →
Website𝕏@afonsoftGitHub

building-mcp-servers

Guides building MCP servers in TypeScript, Python, or C# that expose tools to LLMs.

Updated Jul 21, 2026
Search Tags:#typescript#csharp#python#mcp#model context protocol#server development#llm tools
One-click install
npx skills add https://github.com/afonsoft/gamehub --skill building-mcp-servers-afonsoft
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: building-mcp-servers
Source: https://github.com/afonsoft/gamehub/tree/main/.claude/skills/building-mcp-servers
Command: npx skills add https://github.com/afonsoft/gamehub --skill building-mcp-servers-afonsoft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building a Model Context Protocol server that LLMs can actually use effectively requires navigating SDK documentation, transport choices, tool schema design, and evaluation practices that are easy to get wrong without a structured process. ## Core Features & Use Cases - Four-Phase Workflow: Covers research and planning, implementation, review and testing, and evaluation creation for new MCP servers. - Multi-Language Guides: Provides dedicated implementation references for TypeScript (Zod, registerTool), Python (FastMCP, Pydantic), and C#/.NET (attribute-based tools, DI). - Transport and Auth Coverage: Documents Streamable HTTP, stdio, and OAuth 2.1 patterns including token validation and middleware integration. - Use Case: A developer needs to expose a company's internal API to Claude. The skill walks them through SDK selection, tool naming and annotations, pagination, error handling, and generating a 10-question XML evaluation file. ## Quick Start Use the building-mcp-servers skill to scaffold an MCP server in TypeScript that wraps the GitHub API with proper tool schemas and error handling.

Frequently Asked Questions about building-mcp-servers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build an MCP server in TypeScript?▼

Use the @modelcontextprotocol/sdk package with the McpServer class and registerTool method, defining input schemas with Zod. The skill's TypeScript reference covers project structure, tsconfig setup, and complete working examples with error handling.

What transport should I use for an MCP server?▼

Use Streamable HTTP for remote servers serving multiple clients and stdio for local integrations like Claude Desktop or Cursor. SSE is deprecated and should only be used for legacy scenarios.

Which languages are supported for MCP server development?▼

The skill covers TypeScript, Python, and C#/.NET with official SDKs for each. TypeScript is recommended for its strong SDK support, static typing, and broad tooling ecosystem.

How do I test an MCP server after building it?▼

Verify compilation with npm run build, python -m py_compile, or dotnet build depending on language, then test interactively with the MCP Inspector via npx @modelcontextprotocol/inspector. The skill also guides creating XML evaluation files with 10 complex read-only questions.

Does the C# MCP SDK require prerelease packages?▼

No, the C# SDK is GA as stable 1.x packages. Use ModelContextProtocol for stdio servers, ModelContextProtocol.AspNetCore for HTTP servers, and ModelContextProtocol.Core for client-only scenarios.

Related Skills

Explore More Software Engineering Skills→
dmedina-devdmedina-dev
1

MCP Integration

Integrate external services with Claude Code plugins via MCP servers.

Community
Advanced
scalekit-incscalekit-inc
1

mcp-oauth21-scalekit

Add OAuth 2.1 token validation middleware to MCP servers using Scalekit.

Official
Advanced
hoonsubinhoonsubin

mcp-builder

Guides building and evaluating MCP servers in Python or TypeScript.

Community
Advanced
nicepkgnicepkg
2

resource-scout

Locate Claude Code skills and MCP servers from marketplaces, GitHub, and registries.

Official
Basic