Hands On

MCP服务器实践

这是2025年4月在首尔Doout株式会社东京办公室举办的公司内部学习会的资料。

背景和目的

近年来，生成AI 的进步非常快，学到的知识在短时间内就会过时，这是一个课题。在这样变化激烈的时代，重要的不是特定的技术和知识本身，而是掌握对事物进行“理解”、“分解”、“逻辑性重构”的想法和方法。

本Hanson的目标是提供通过编程获得这种想法的契机。编程是体验将复杂问题分解得较小并构建解决方案过程的最佳途径。希望通过这个机会，能成为掌握解决问题的普遍技能的契机。

这次制作的东西

这次是可以获取志愿者开发的口袋妖怪信息的开源项目的 PokéAPI 使用口袋妖怪的ID（1〜151）输入名称并获取游戏中的香味文本MCP 创建服务器。

\[！警告\]\ 始终是有志之士制作的API 来修改标记元素的显示属性。超过必要API 执行。请不要用于侵犯权利人权利的用途。

汉斯通的终点

1. MCP 总觉得理解服务器的结构
2. JavaScript/TypeScript 理解
3. 一边写代码一边移动服务器，学习追加、公开工具的流程

推进方法

• 全部6步，完成小的成果物的同时进行
• 疑问随时通过聊天和口头解决

自我学习时掌握的知识

• JavaScript/TypeScript 基本语法类型系统
• Node.js 环境中的脚本执行经验
• 命令行（CLI）的基本操作
• HTTP 请求（GET/POST）工作原理

目次

以下目录为附件的 README.md 中所述修改相应参数的值。

1. Step 1: MCP/MCP 什么是服务器？能做什么呢？\

1.1 MCP（模型上下文协议）\ 1.2 MCP 服务器\ 1.3为什么MCP 有必要吗？\ 1.4一般体系结构\ 1.5 MCP 利用服务器

1. \

2.1 Node.js 什么是模块库？\ 2.2 package.json 内容解说\ 2.3安装手持编程器所需的模块

1. Step 3: import 语法说明\

3.1.使用模块说明

1. Step 4: MCP 服务器工具实施\

4.1服务器实例化\ 4.2工具（端点）的定义\ 4.3 PokéAPI 数据检索\ 4.4提取日语香味文本和名称\ 4.5响应形式的组装\ 4.6服务器启动\ 4.7构建和行为确认

1. Step 5: 定义工具元信息\

5.1定义元信息的含义\ 5.2注册用于工具列表请求的处理程序\ 5.3确认定义的信息

1. Step 6: Claude Desktop 从…开始MCP 连接到服务器\

6.1 Claude Desktop 打开\ 6.2打开开发人员配置文件\ 6.3 MCP 注册服务器\ 6.4 Claude Desktop 确认动作

______________________________________________________________________

补足

• JavaScript/TypeScript\

Web 或在服务器上运行的脚本语言。TypeScript 表示JavaScript 类型信息的语言。

• Node.js\

JavaScript 在服务器上运行的运行时环境。

• CLI（命令行界面）\

在基于文字的操作画面中直接输入命令进行操作的环境。

• HTTP 请求\

客户端到服务器的请求。主要GET（获取）和POST（发送）。