Pokemcp

🚀 Poke - MCP

Poke - MCP 是一個基於模型上下文協議（MCP）的服務器，藉助標準化接口提供精靈寶可夢的相關信息。它連接到 PokeAPI 來獲取精靈寶可夢的數據，再通過 MCP 工具向任何兼容的客戶端（如 Claude Desktop App、Continue、Cline 等）提供信息，為用戶帶來便捷的精靈寶可夢信息查詢體驗。

🚀 快速開始

安裝

使用 Smithery 安裝

通過 Smithery 可自動為 Claude Desktop 安裝 Poké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 Desktop App 一起使用

1. 下載並安裝 Claude Desktop App
2. 打開 Claude Desktop 設置
3. 進入開發者設置，編輯配置文件
4. 添加以下配置：

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

5. 重啟 Claude Desktop
6. 您現在應該可以在 Claude 中看到精靈寶可夢工具

示例查詢

連接到 MCP 客戶端後，您可以提出以下問題：

• “告訴我關於皮卡丘”
• “給我一個隨機精靈寶可夢”
• “顯示一個來自卡託的隨機精靈寶可夢”
• “有什麼隨機的水屬性精靈寶可夢？”

✨ 主要特性

• 通過名稱獲取特定精靈寶可夢的詳細信息
• 發現隨機精靈寶可夢
• 查找來自特定地區的隨機精靈寶可夢（卡託、喬託、赫昂等）
• 獲取特定類型的隨機精靈寶可夢（火、水、電等）
• 支持自然語言查詢接口，用於獲取精靈寶可夢信息

🔧 技術細節

工作原理

Poke - MCP 使用 模型上下文協議 構建，使人工智能應用程序能夠以標準化方式訪問外部工具和數據源。該服務器的工作流程如下：

1. 連接到 PokeAPI 獲取精靈寶可夢數據
2. 通過 MCP 接口提供多個工具
3. 處理來自 MCP 客戶端的請求
4. 返回格式化的精靈寶可夢信息

MCP 工具

服務器提供的工具包括：

• get - pokemon: 根據名稱獲取特定精靈寶可夢的詳細信息
• random - pokemon: 獲取隨機精靈寶可夢的信息
• random - pokemon - from - region: 從指定地區獲取隨機精靈寶可夢
• random - pokemon - by - type: 根據類型獲取隨機精靈寶可夢
• pokemon - query: 回答關於精靈寶可夢的自然語言查詢

架構

服務器使用以下技術構建：

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

📚 詳細文檔

項目結構

• src/index.ts: 主服務器實現
• src/types.ts: TypeScript 數據類型定義
• package.json: 項目依賴項和腳本
• tsconfig.json: TypeScript 配置

添加新功能

要添加新的工具或增強現有功能，可按以下步驟操作：

1. 定義新的助手函數以獲取和格式化數據
2. 使用 server.tool() 方法註冊新的工具
3. 實現工具邏輯以處理請求並返回響應