Pokémon Data

🚀 Poke - MCP

Poke - MCP 是一個基於模型上下文協議（MCP）構建的服務，它通過統一接口為用戶提供 Pokémon 信息。該服務連接 PokeAPI 獲取 Pokémon 數據，並藉助 MCP 工具為 Claude 桌面應用、Continue、Cline 等兼容客戶端提供數據支持，讓用戶能更便捷地查詢 Pokémon 相關信息。

🚀 快速開始

Poke - MCP 藉助模型上下文協議（MCP），實現了 AI 應用程序與外部數據源的標準化交互。以下是其工作流程：

1. 連接到 PokeAPI 獲取 Pokémon 數據。
2. 通過 MCP 接口暴露多個工具。
3. 處理 MCP 客戶端請求。
4. 返回格式化 Pokémon 信息。

✨ 主要特性

• 通過名稱查詢特定 Pokémon 的詳細信息。
• 隨機獲取 Pokémon 信息。
• 根據地區查找隨機 Pokémon（如卡洛斯、豐緣、神奧等）。
• 按類型篩選隨機 Pokémon（如火、水、電等）。
• 支持自然語言查詢 Pokémon 相關問題。

📦 安裝指南

使用 Smithery 快速安裝

通過 [Smithery](https://smithery.ai/server/@NaveenBandarage/poke - mcp) 可自動為 Claude 桌面應用安裝 Poke - MCP：

npx -y @smithery/cli install @NaveenBandarage/poke-mcp --client claude

手動安裝

# 克隆倉庫
git clone https://github.com/yourusername/poke-mcp.git
cd poke-mcp

# 安裝依賴項
npm install

# 構建項目
npm run build

💻 使用示例

在 Claude 桌面應用中使用

1. 下載並安裝 Claude 桌面應用。
2. 打開 Claude 設置界面。
3. 進入開發者設置，編輯配置文件。
4. 添加以下配置：

{
  "mcpServers": {
    "pokedex": {
      "command": "path/to/poke-mcp/build/index.js"
    }
  }
}

5. 重啟 Claude 桌面應用。
6. 現在您應該可以看到 Pokémon 工具已集成到 Claude。

示例查詢

連接到 MCP 客戶端後，可以執行以下命令：

• "告訴我關於皮卡丘的信息"
• "給我一個隨機的精靈"
• "展示一個來自卡洛斯地區的隨機精靈"
• "有什麼水屬性的精靈？"

項目結構

• src/index.ts：主服務實現。
• src/types.ts：TypeScript 類型定義文件。
• package.json：項目依賴及腳本信息。
• tsconfig.json：TypeScript 配置文件。

擴展新功能

要添加新工具或增強現有功能：

1. 定義新的輔助函數以獲取和格式化數據。
2. 使用 server.tool() 方法註冊新工具。
3. 實現具體的業務邏輯。

🔧 技術細節

服務採用以下技術構建：

• TypeScript
• MCP TypeScript SDK (@modelcontextprotocol/sdk)
• Zod 進行輸入驗證
• 標準 I/O 傳輸協議實現 MCP 通信

📄 許可證

本項目遵循 MIT 許可證協議。