Loading…

How to Build MCP Servers for Claude Code (Complete Tutorial) | WOWHOW

AI Tools & Tutorials

How to Build MCP Servers for Claude Code (Complete Tutorial)

Q: What languages can MCP servers be built in?

The official SDK supports TypeScript/JavaScript and Python. Community SDKs exist for Go, Rust, and other languages.

Q: How many tools can an MCP server expose?

There’s no hard limit, but keep it focused. A server with 5-10 well-defined tools is better than one with 50 vague tools. Claude needs to understand what each tool does to use it effectively.

Step-by-step tutorial for building MCP (Model Context Protocol) servers for Claude Code. TypeScript implementation with examples for database, API, and file sys

WOWHOWProduct & engineering

Published 20 March 2026 · 4 min read

TL;DR

Step-by-step tutorial for building MCP (Model Context Protocol) servers for Claude Code. TypeScript implementation with examples for database, API, and file sys

The Model Context Protocol (MCP) is what makes Claude Code extensible. It’s the standard that lets you give Claude access to your databases, APIs, file systems, and any custom tool you can imagine.

Building an MCP server is surprisingly straightforward. Let’s build one from scratch.

What is MCP?

MCP is a protocol that standardizes how AI models communicate with external tools. Think of it as USB for AI — a universal connector that lets any AI model use any tool.

An MCP server:

Defines available tools (what can Claude do?)
Handles tool calls (Claude says “query the database,” the server executes it)
Returns results (sends data back to Claude)

Setting Up Your First MCP Server

Step 1: Project Setup

mkdir my-mcp-server
cd my-mcp-server
npm init -y
npm install @modelcontextprotocol/sdk zod
npm install -D typescript @types/node tsx
npx tsc --init

Step 2: Basic Server Structure

// src/index.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

const server = new McpServer({
  name: 'my-custom-tools',
  version: '1.0.0',
});

// Define a simple tool
server.tool(
  'greet',
  'Greet a user by name',
  {
    name: z.string().describe('The name to greet'),
  },
  async ({ name }) => ({
    content: [
      {
        type: 'text',
        text: `Hello, ${name}! Welcome to my MCP server.`,
      },
    ],
  })
);

// Start the server
async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
}

main().catch(console.error);

Step 3: Register with Claude Code

// In your project's .claude/settings.json or CLAUDE.md:
// Add the MCP server configuration
{
  "mcpServers": {
    "my-tools": {
      "command": "npx",
      "args": ["tsx", "/path/to/my-mcp-server/src/index.ts"]
    }
  }
}

You might also need

Browse all

Free, no signup

Tools that go with this post

Developer

JSON Formatter & Validator

Format, validate & diff JSON — runs entirely in browser

Open →Developer

cURL to Code Converter

Convert cURL commands to Python, JavaScript, Go, and PHP

Open →Developer

Regex Playground

Test regex live — railroad diagrams + plain English explained

Open →Developer

Base64 Encoder / Decoder

Encode/decode text & files — URL-safe, MIME, data URLs

Open →Utilities

UUID Generator

Generate unique IDs with one click

Open →

Pairs with this note

More from AI Tools & Tutorials

See all

AI Tools & Tutorials8 min

Do Not Hire 12 Agents. Write 12 Skills. A Creator OS.

The fastest-growing agent repositories in September 2026 are not multi-agent frameworks. They are skill libraries: anthropics/skills, awesome-agent-skills with more than a thousand entries, NVIDIA/skills, 380-skill community packs. A skill is reusable competence a single agent loads on demand. An agent crew is rented attention that talks to itself. This is the decision table, the skill-file anatomy and the daily ritual that turn a strong single agent into a Creator OS.

20 Sept 2026Read →

AI Tools & Tutorials8 min

macOS 27 Ships an LLM in Your Terminal: The fm Playbook

macOS 27 preinstalls fm, a command-line front end to the same on-device and Private Cloud Compute models that run Apple Intelligence. No account, no API key, no per-token bill. fm chat for a conversation, fm respond for scripts, structured JSON output and an OpenAI-compatible local server. This is the shell playbook: five pipe recipes worth keeping, where it fails, and when to reach for mlx_lm or Ollama instead.

20 Sept 2026

Building a Database MCP Server

The most common use case: giving Claude access to your database.

// src/database-server.ts
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';
import { Pool } from 'pg';

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
});

const server = new McpServer({
  name: 'database-tools',
  version: '1.0.0',
});

// Read-only query tool
server.tool(
  'query_database',
  'Execute a read-only SQL query against the database',
  {
    sql: z.string().describe('The SQL SELECT query to execute'),
  },
  async ({ sql }) => {
    // Safety: only allow SELECT queries
    if (!sql.trim().toUpperCase().startsWith('SELECT')) {
      return {
        content: [{
          type: 'text',
          text: 'Error: Only SELECT queries are allowed.',
        }],
        isError: true,
      };
    }

    try {
      const result = await pool.query(sql);
      return {
        content: [{
          type: 'text',
          text: JSON.stringify(result.rows, null, 2),
        }],
      };
    } catch (error) {
      return {
        content: [{
          type: 'text',
          text: `Query error: ${error.message}`,
        }],
        isError: true,
      };
    }
  }
);

// Table schema tool
server.tool(
  'list_tables',
  'List all tables in the database with their columns',
  {},
  async () => {
    const result = await pool.query(`
      SELECT table_name, column_name, data_type
      FROM information_schema.columns
      WHERE table_schema = 'public'
      ORDER BY table_name, ordinal_position
    `);
    return {
      content: [{
        type: 'text',
        text: JSON.stringify(result.rows, null, 2),
      }],
    };
  }
);

Building an API Integration Server

// src/api-server.ts
server.tool(
  'search_github',
  'Search GitHub repositories',
  {
    query: z.string().describe('Search query for repositories'),
    language: z.string().optional().describe('Filter by programming language'),
  },
  async ({ query, language }) => {
    const params = new URLSearchParams({
      q: language ? `${query} language:${language}` : query,
      sort: 'stars',
      order: 'desc',
    });

    const response = await fetch(
      `https://api.github.com/search/repositories?${params}`,
      { headers: { 'Accept': 'application/vnd.github.v3+json' } }
    );

    const data = await response.json();
    const repos = data.items.slice(0, 10).map(repo => ({
      name: repo.full_name,
      description: repo.description,
      stars: repo.stargazers_count,
      url: repo.html_url,
    }));

    return {
      content: [{
        type: 'text',
        text: JSON.stringify(repos, null, 2),
      }],
    };
  }
);

Security Best Practices

Never allow write operations without confirmation — read-only by default
Validate and sanitize all inputs — use Zod schemas for type safety
Limit query scope — restrict database access to specific schemas/tables
Log all tool calls — audit trail for debugging and security
Use environment variables for credentials — never hardcode secrets
Rate limit tool calls — prevent runaway agent behavior

How to Build MCP Servers for Claude Code (Complete Tutorial)

What is MCP?

Setting Up Your First MCP Server

Step 1: Project Setup

Step 2: Basic Server Structure

Step 3: Register with Claude Code

You might also need

Claude Code Mastery — Advanced System Prompt Engineering Pack

MCP Server Development Masterclass — 50 Prompts

Claude Code Multi-Agent Development System — 50 Production Prompts

Tools that go with this post

JSON Formatter & Validator

cURL to Code Converter

Regex Playground

Base64 Encoder / Decoder

UUID Generator

More from AI Tools & Tutorials

Do Not Hire 12 Agents. Write 12 Skills. A Creator OS.

macOS 27 Ships an LLM in Your Terminal: The fm Playbook

Building a Database MCP Server

Building an API Integration Server

Security Best Practices

People Also Ask

What languages can MCP servers be built in?

Can MCP servers run remotely?

How many tools can an MCP server expose?

One insight, every Monday. 7am IST.

Need production-ready templates?

Comments · 0

Claude Code Aug–Sept 2026 Settings — 12 Worth Enabling Today

How Teams Manage Skills Files — /skill-doctor, Git, Evals

Devin Desktop ACP Setup — Codex, Claude, OpenCode in One IDE

Gemini API Shutdowns 30 Sept — omni-flash-preview Migration Guide

What is MCP?

Setting Up Your First MCP Server

Step 1: Project Setup

Step 2: Basic Server Structure

Step 3: Register with Claude Code

You might also need

Claude Code Mastery — Advanced System Prompt Engineering Pack

MCP Server Development Masterclass — 50 Prompts

Claude Code Multi-Agent Development System — 50 Production Prompts

Tools that go with this post

JSON Formatter & Validator

cURL to Code Converter

Regex Playground

Base64 Encoder / Decoder

UUID Generator

More from AI Tools & Tutorials

Do Not Hire 12 Agents. Write 12 Skills. A Creator OS.

macOS 27 Ships an LLM in Your Terminal: The fm Playbook

Building a Database MCP Server

Building an API Integration Server

Security Best Practices

People Also Ask

What languages can MCP servers be built in?

Can MCP servers run remotely?

How many tools can an MCP server expose?

Related reading

One insight, every Monday. 7am IST.

Need production-ready templates?

Comments · 0

Claude Code Aug–Sept 2026 Settings — 12 Worth Enabling Today

How Teams Manage Skills Files — /skill-doctor, Git, Evals

Devin Desktop ACP Setup — Codex, Claude, OpenCode in One IDE

Gemini API Shutdowns 30 Sept — omni-flash-preview Migration Guide