AI导哈

MCP服务器开发

通过PokéAPI获取宝可梦信息的MCP服务器开发实践，旨在帮助开发者理解服务器架构和JavaScript/TypeScript编程。

  • by KeisukeKudo
  • 本地部署
  • 更新于
在 GitHub 查看 keisukekudo/mcp-server-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 利用服务器

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

  3. Step 3: import 语法说明
    3.1.使用模块说明

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

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

  6. 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（发送）。

相关 MCP