Pokemon AI聊天机器人

一个基于Pokemon API和自然语言处理的聊天机器人,提供Pokemon信息查询、类型搜索、世代搜索、类型相克查询、能力值分析和自然语言对话功能。

  • by DimbongCHOI
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 DimbongCHOI/mcp-poke

使用说明

一般功能:通过Cursor聊天运行!! 正在开发基于React的Web应用程序!! -> npm run full:dev

🎮 口袋妖怪AI聊天机器人

利用Pokemon API的模型上下文协议(MCP)服务器和自然语言处理聊天机器人。

主要功能

  • 🔍 查询口袋妖怪信息:通过姓名或图鉴号码确认口袋妖怪的详细信息
  • ⚡ 按类型搜索口袋妖怪:查看特定类型的口袋妖怪列表
  • 🌟 搜索各代口袋妖怪:“第一代龙类型口袋妖怪”等综合搜索
  • 🎯 查询类型属性:“火焰对草有效吗?”同样的问题
  • 📊 能力值分析:口袋妖怪的属性信息和图表
  • 🗣️ 自然语言对话:用韩语自然地对话

🌐 GitHub Pages分发(公共URL)

📋 部署阶段

1️⃣ 创建GitHub存储库

# GitHub에서 새 저장소 생성 (예: mcp-poke)
# 저장소 이름을 기억해두세요!

2️⃣ 项目推送

git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/[사용자명]/mcp-poke.git
git push -u origin main

3️⃣ GitHub Pages设置

  1. GitHub存储库→ 设置 选项卡
  2. 从左菜单 页面 点击
  3. 来源:选择“GitHub Actions”
  4. 保存后自动开始部署!

4️⃣ 部署完成

  • 几分钟后可在以下URL中找到:
https://[사용자명].github.io/mcp-poke/

🔄 部署更新

git add .
git commit -m "Update"
git push

→GitHub Actions自动运行并重新部署!


🚀 快速入门指南

⚙️ 基本要求

  • Node.js 18或更高版本 需要安装

📦 步骤1:下载项目

git clone <repository-url>
cd mcp-poke

📥 步骤2:安装软件包

npm install

首次安装⏱ENT可能需要2-3分钟。

🎮 步骤3:选择执行方法

💬 启动控制台聊天机器人

npm start

在终端直接对话,查询口袋妖怪信息



🛠️ 开发模式

更改文件时自动重新启动

npm run dev

运行测试

npm test

💬 使用示例

查询口袋妖怪信息

🎮 포켓몬 챗봇> 피카츄 정보 보여줘
🎮 포켓몬 챗봇> 리자몽 능력치 알려줘
🎮 포켓몬 챗봇> 꼬부기 상세 정보

按类型搜索口袋妖怪

🎮 포켓몬 챗봇> 전기 타입 포켓몬 알려줘
🎮 포켓몬 챗봇> 불꽃 타입은 어떤 포켓몬들이 있어?
🎮 포켓몬 챗봇> 물 타입 포켓몬들 보여줘

搜索口袋妖怪

🎮 포켓몬 챗봇> 불꽃으로 시작하는 포켓몬 찾아줘
🎮 포켓몬 챗봇> 전기 포켓몬 검색
🎮 포켓몬 챗봇> 어떤 포켓몬이 파이로 시작해?

其他命令

🎮 포켓몬 챗봇> 포켓몬 타입들 알려줘
🎮 포켓몬 챗봇> quit

🏗️ 项目结构

src/
├── server.js          # MCP 서버 (포켓몬 API 도구들)
├── chatbot.js         # 자연어 처리 챗봇
├── pokemon-api.js     # 포켓몬 API 클라이언트
├── config.js          # 설정 및 타입 매핑
├── index.js           # 메인 애플리케이션
└── test.js            # 테스트 스크립트

🛠️ MCP工具

1. get_pokemon_info

查询口袋妖怪的详细信息。

  • 参数: identifier (口袋妖怪的名字或ID)

2. get_pokemon_by_type

查看特定类型的口袋妖怪列表。

  • 参数: type (口袋妖怪类型)

3. get_pokemon_types

查看所有口袋妖怪类型的列表。

4. search_pokemon

用口袋妖怪的名字搜索。

  • 参数: query (查询)

5. get_pokemon_stats

查询口袋妖怪的能力值信息。

  • 参数: identifier (口袋妖怪的名字或ID)

🎯 支持的口袋妖怪类型

  • 野马,火焰,水,草,电,冰,格斗,毒
  • 地,飞行,埃斯珀,虫子,岩石,幽灵,龙,恶
  • 钢铁,仙女座

🧪 测试

npm test

测试将验证以下内容:

  • Pokemon API连接和数据查询
  • 韩语口袋妖怪名称映射
  • 聊天机器人意图分析
  • 调用MCP工具

🔧 技术堆栈

  • Node.js:运行时环境
  • MCP-SDK:Model Context Protocol实现
  • 阿西奥斯:HTTP客户端
  • 口袋妖怪API:口袋妖怪数据源
  • 编辑功能:交互式界面

📝 许可证

MIT许可证

🤝 贡献

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支机构(git push origin feature/AmazingFeature)
  5. 打开拉取请求

💡 提示:请自然地像对话一样说话!聊天机器人会了解您的意图,并提供适当的信息。