Mcp Server Hands On

🚀 MCP 服务器动手实践

本项目聚焦于 MCP 服务器的创建与实践，借助开源的 PokéAPI，让参与者通过编程体验将复杂问题分解并构建解决方案的过程，从而掌握解决问题的通用技能。

🚀 快速开始

背景与目标

近年来，生成式人工智能发展迅猛，知识更新换代极快，所学知识短时间内就可能过时。在这个快速变化的时代，关键并非特定的技术或知识，而是理解、分解和逻辑重构事物的思维方式与方法。

本次动手实践旨在通过编程提供获取这种思维方式的机会。编程过程就是把复杂问题拆解为小部分并构建解决方案，非常适合体验这一过程。期望通过本次实践，参与者能掌握解决问题的通用技能。

本次创建的内容

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

⚠️ 重要提示

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

动手实践的目标

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

进行方式

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

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

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

📚 详细文档

目录

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

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

2. 
   2.1 Node.js 模块
   2.2 命令行接口（CLI）

3. 
   3.1 初始化项目并安装依赖项
   3.2 配置 TypeScript
   3.3 编写基本的服务器代码

4. 
   4.1 使用 Axios 处理 HTTP 请求
   4.2 实现与 PokéAPI 的通信

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

6. 
   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（提交）。