mcp-server-hands-on

mcp-server-hands-on

3.3

This document is a summary of a hands-on session held at SoldOut Inc.'s Tokyo office in April 2025, focusing on MCP server technology.

The hands-on session aims to equip participants with the ability to 'understand,' 'decompose,' and 'reconstruct logically' through programming. The session uses the PokéAPI to create an MCP server that retrieves Pokémon information based on an ID input. The goal is to understand the workings of an MCP server, grasp JavaScript/TypeScript syntax, and learn how to write code to operate a server and add tools. The session is structured into six steps, each building towards a small deliverable, and encourages participants to resolve queries through chat or verbal communication. Key knowledge areas include JavaScript/TypeScript basics, Node.js scripting, CLI operations, and HTTP requests.

Features

  • Understanding MCP server architecture and functionality.
  • Learning JavaScript/TypeScript syntax and Node.js environment.
  • Implementing tools and endpoints using PokéAPI.
  • Building and verifying server operations.
  • Connecting MCP server with Claude Desktop for testing.

MCP Tools

  • {'PokéAPI Integration': 'Tool to fetch Pokémon data using PokéAPI.'}

Usage with Different Platforms

Node.js

javascript
const express = require('express');
const fetch = require('node-fetch');
const app = express();

app.get('/pokemon/:id', async (req, res) => {
  const id = req.params.id;
  const response = await fetch(`https://pokeapi.co/api/v2/pokemon/${id}`);
  const data = await response.json();
  res.json({ name: data.name, flavor_text: data.flavor_text_entries[0].flavor_text });
});

app.listen(3000, () => {
  console.log('MCP server running on port 3000');
});

Frequently Asked Questions

What is the purpose of the hands-on session?

The session aims to teach participants how to understand, decompose, and reconstruct problems logically through programming.

What is the main tool used in the session?

The main tool used is the PokéAPI, which is integrated into the MCP server to fetch Pokémon data.

What programming languages are focused on in the session?

The session focuses on JavaScript and TypeScript.