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