MCP Server Hands On

该项目是一个通过PokéAPI获取宝可梦信息的MCP服务器开发教程，旨在通过编程实践培养问题分解与逻辑重构能力，包含6个步骤从基础概念到实际部署。

开发者工具教育与学习工具 #MCP服务 #API开发 #编程学习 #Node.js 本地 .TypeScript

评分 : 2分

下载量 : 8

更新时间 : 2025-04-28

什么是MCP服务器?

MCP(Model Context Protocol)服务器是一个连接AI模型与外部工具的中间件，本次项目通过构建能查询宝可梦信息的服务来学习其工作原理

如何使用MCP服务器?

通过Claude Desktop客户端连接本地运行的MCP服务器，发送宝可梦ID即可获取相应信息

适用场景

适合需要扩展AI模型能力的场景，比如： - 访问实时数据 - 连接专业数据库 - 执行特定计算任务

主要功能

宝可梦数据查询通过PokéAPI获取第一世代(1-151)宝可梦的详细信息

本地开发服务器基于Node.js的轻量级服务器，方便开发者快速测试

Claude无缝集成支持与Claude Desktop客户端直接对接

优势与局限性

优势

实践性强：通过具体项目学习MCP架构

模块化设计：清晰展示各组件关系

技术栈通用：使用JavaScript/TypeScript等流行技术

局限性

仅支持第一世代宝可梦查询

依赖第三方PokéAPI服务稳定性

需要基本编程知识才能自定义开发

如何使用

环境准备

安装Node.js运行环境(建议v18+)

依赖安装

在项目目录执行npm安装命令

服务器启动

运行开发服务器

客户端连接

在Claude Desktop中添加MCP服务器地址

使用案例

查询皮卡丘信息获取皮卡丘(ID:25)的名称和游戏描述

比较宝可梦同时查询多个宝可梦进行对比

常见问题

为什么只能查询1-151的宝可梦?

需要编程基础吗?

如何扩展更多功能?

🚀 MCP 服务器动手实践

本次动手实践聚焦于 MCP 服务器的创建，借助开源项目 PokéAPI 开展编程活动。旨在让参与者在快速变化的时代，通过编程掌握理解、分解和逻辑重构事物的思维方式，进而掌握解决问题的通用技能。

✨ 主要特性

思维培养：通过编程体验将复杂问题分解为小部分并构建解决方案的过程，培养解决问题的通用思维。
知识学习：帮助参与者理解 MCP/MCP 服务器的基本概念，掌握 JavaScript/TypeScript 的语法。
技能掌握：让参与者掌握编写代码并运行服务器，以及工具的添加和发布的流程。

📦 安装指南

文档中未提及具体安装命令，此部分跳过。

💻 使用示例

文档中未提供代码示例，此部分跳过。

📚 详细文档

背景与目标

近年来，生成式人工智能发展迅猛，所学知识易过时。在这个快速变化的时代，理解、分解和逻辑重构事物的思维方式和方法比特定技术或知识本身更重要。本次动手实践通过编程提供获得这种思维方式的机会，编程过程适合体验将复杂问题分解并构建解决方案，希望参与者通过实践掌握解决问题的通用技能。

本次创建的内容

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

⚠️ 重要提示

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

动手实践的目标

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

进行方式

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

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

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

第 1 步：MCP/MCP 服务器是什么？能做什么？
1.1 MCP（模型上下文协议）
1.2 MCP 服务器
1.3 为什么需要 MCP？
1.4 通用架构
1.5 MCP 服务器的用途
第 2 步：Node.js 模块和 CLI 的基本概念
2.1 Node.js 模块
2.2 命令行接口（CLI）
第 3 步：使用 Node.js 和 TypeScript 创建 MCP 服务器
3.1 初始化项目并安装依赖项
3.2 配置 TypeScript
3.3 编写基本的服务器代码
第 4 步：集成 HTTP 请求功能
4.1 使用 Axios 处理 HTTP 请求
4.2 实现与 PokéAPI 的通信
第 5 步：配置和运行 MCP 服务器
5.1 配置环境变量
5.2 启动服务器并进行初步测试
第 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（提交）。