MCP 服务器动手实践

背景与目标

近年来，生成式人工智能的发展速度非常快，所学的知识在短时间内就会过时，这成为一个问题。在这种快速变化的时代，重要的不是特定的技术或知识本身，而是理解、分解和逻辑重构事物的思维方式和方法。

本次动手实践中，旨在通过编程提供获得这种思维方式的机会。编程是一个将复杂的问题分解为小部分并构建解决方案的过程，非常适合体验这样的过程。希望通过本次实践，能够掌握解决问题的通用技能。

本次创建的内容

本次将使用有志者开发的获取 Pokémon 信息的开源项目 PokéAPI，创建一个 MCP 服务器，输入 Pokémon 的 ID（1-151），获取名称和游戏内 flavor 文本。

[!WARNING]
这只是一个由有志者开发的 API。请不要过度调用 API，并注意不要侵犯相关权益者的权利。

动手实践的目标

1. 理解 MCP/MCP 服务器的基本概念
2. 理解 JavaScript/TypeScript 的语法
3. 掌握编写代码并运行服务器，以及工具的添加和发布的流程

进行方式

• 共分为 6 个步骤，逐步完成小成果
• 随时通过聊天或口头交流解决问题

自我学习时需要掌握的关键知识

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

目录

以下是基于附带的 README.md 制作的目录：

1. 第 1 步：MCP/MCP 服务器是什么？能做什么？
   1.1 MCP（模型上下文协议）
   1.2 MCP 服务器
   1.3 为什么需要 MCP？
   1.4 通用架构
   1.5 MCP 服务器的用途

2. 第 2 步：Node.js 模块和 CLI 的基本概念
   2.1 Node.js 模块
   2.2 命令行接口（CLI）

3. 第 3 步：使用 Node.js 和 TypeScript 创建 MCP 服务器
   3.1 初始化项目并安装依赖项
   3.2 配置 TypeScript
   3.3 编写基本的服务器代码

4. 第 4 步：集成 HTTP 请求功能
   4.1 使用 Axios 处理 HTTP 请求
   4.2 实现与 PokéAPI 的通信

5. 第 5 步：配置和运行 MCP 服务器
   5.1 配置环境变量
   5.2 启动服务器并进行初步测试

6. 第 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 请求
  客户端向服务器发送的请求。主要的 HTTP 方法包括 GET（获取）和 POST（提交）。