Pokemcp

🚀 寶可夢MCP服務器

寶可夢MCP服務器是一個基於模型上下文協議（MCP）的服務器，它通過標準化工具提供寶可夢數據。這個單倉庫項目包含了MCP服務器以及用於從PokeAPI獲取寶可夢數據的數據攝取服務。

🚀 快速開始

前提條件

• Node.js 18+
• PNPM
• Git

安裝

1. 克隆倉庫：

git clone https://github.com/grovesjosephn/pokemcp.git
cd pokemcp

2. 安裝依賴：

pnpm install

3. 配置數據庫：

./scripts/setup.sh

4. 構建所有包：

pnpm build

使用方法

運行MCP服務器

# 開發模式（熱重載）
pnpm dev

# 生產模式
cd packages/pokemon-mcp-server
pnpm start

使用MCP Inspector進行測試

# 可視化圖形界面測試
cd packages/pokemon-mcp-server
pnpm inspect

# 命令行界面測試
pnpm inspect:cli

數據攝取

# 運行數據攝取
cd packages/pokemon-mcp-ingestion
pnpm start

✨ 主要特性

可用的MCP工具

• get_pokemon - 獲取特定寶可夢的詳細信息
• search_pokemon - 按名稱、類型或其他標準搜索寶可夢
• get_strongest_pokemon - 根據各種統計數據找出最強的寶可夢
• get_pokemon_stats - 獲取寶可夢的詳細統計數據
• compare_pokemon - 比較兩隻寶可夢的統計數據
• get_type_effectiveness - 獲取屬性相剋信息

數據覆蓋範圍

• 來自PokeAPI的完整寶可夢數據
• 統計數據、屬性、特性等
• 屬性相剋關係
• 可按多個標準搜索

📦 安裝指南

克隆倉庫

git clone https://github.com/grovesjosephn/pokemcp.git
cd pokemcp

安裝依賴

pnpm install

配置數據庫

./scripts/setup.sh

構建所有包

pnpm build

💻 使用示例

基礎用法

運行MCP服務器

# 開發模式（熱重載）
pnpm dev

# 生產模式
cd packages/pokemon-mcp-server
pnpm start

高級用法

數據攝取

# 運行數據攝取
cd packages/pokemon-mcp-ingestion
pnpm start

📚 詳細文檔

Claude桌面集成

選項1：NPM包（推薦）

全局安裝服務器：

cd packages/pokemon-mcp-server
pnpm build
npm link

配置Claude桌面：

{
  "mcpServers": {
    "pokemon": {
      "command": "pokemon-mcp-server",
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

選項2：直接執行Node命令

{
  "mcpServers": {
    "pokemon": {
      "command": "node",
      "args": ["/path/to/pokemcp/packages/pokemon-mcp-server/dist/server.js"],
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

選項3：開發模式

{
  "mcpServers": {
    "pokemon": {
      "command": "pnpm",
      "args": ["--filter", "pokemon-mcp-server", "start"],
      "cwd": "/path/to/pokemcp",
      "env": {
        "POKEMON_DATA_DIR": "/path/to/pokemcp/data"
      }
    }
  }
}

開發

工作區命令

pnpm build         # 構建所有包
pnpm dev           # 在開發模式下運行所有包
pnpm test          # 運行所有包的測試
pnpm lint          # 檢查所有包的代碼規範
pnpm format        # 格式化所有文件
pnpm format:check  # 檢查格式化情況

服務器包命令

cd packages/pokemon-mcp-server

pnpm build         # 編譯TypeScript
pnpm dev           # 監聽模式（使用tsx）
pnpm start         # 運行服務器
pnpm inspect       # 運行MCP Inspector圖形界面
pnpm inspect:cli   # 運行MCP Inspector命令行界面
pnpm test          # 運行測試

攝取包命令

cd packages/pokemon-mcp-ingestion

pnpm build         # 編譯TypeScript
pnpm dev           # 監聽模式
pnpm start         # 運行攝取
pnpm test          # 運行測試

測試

該項目使用Vitest進行測試：

# 運行所有測試
pnpm test

# 運行特定包的測試
pnpm --filter pokemon-mcp-server test
pnpm --filter pokemon-mcp-ingestion test

數據庫架構

SQLite數據庫包含以下表：

• pokemon - 寶可夢基本信息
• stats - 寶可夢統計數據（生命值、攻擊力、防禦力等）
• types - 寶可夢屬性及關係
• abilities - 寶可夢特性
• type_effectiveness - 屬性相剋關係

貢獻代碼

1. 分叉倉庫
2. 創建特性分支
3. 進行更改
4. 添加測試
5. 運行pnpm format和pnpm lint
6. 提交拉取請求

提交準則

使用常規提交格式：

<類型>[可選範圍]: <描述>

示例:
- feat(server): 添加寶可夢進化鏈工具
- fix(ingestion): 優雅處理缺失的物種URL
- docs: 更新集成指南

🔧 技術細節

本項目是一個PNPM單倉庫項目，包含兩個主要包：

• pokemon-mcp-server：通過標準化工具公開寶可夢數據的MCP服務器
• pokemon-mcp-ingestion：從PokeAPI獲取數據並存儲在SQLite中的數據攝取服務

系統使用共享的SQLite數據庫（data/pokemon.sqlite）來存儲寶可夢數據。

📄 許可證

本項目採用MIT許可證，詳情請參閱LICENSE文件。

🔗 鏈接

• 模型上下文協議
• PokeAPI
• Claude桌面