返回 MCP 目录
public公开dns本地运行

pokemon-paste-mcp

一个用于创建宝可梦对战配置的MCP服务器工具,可将宝可梦数据转换为Pokepaste分享链接

article

README

🚀 宝可梦粘贴MCP服务器

宝可梦粘贴MCP服务器用于创建宝可梦粘贴(宝可梦配招表)。

🚀 快速开始

宝可梦粘贴MCP服务器可用于创建宝可梦配招表。下面将为你介绍安装、使用、测试等方面的内容。

✨ 主要特性

  • 提供 create_pokepaste 工具,可接受宝可梦配招数据并创建宝可梦配招表URL。
  • 支持从npm安装和从源码安装两种方式。
  • 可配置MCP客户端以使用该服务器。

📦 安装指南

从npm安装(推荐)

npm install -g pokemon-paste-mcp

从源码安装

npm install
npm run build

💻 使用示例

基础用法

服务器提供了一个 create_pokepaste 工具,该工具接受宝可梦配招数据并创建一个宝可梦配招表URL。

工具:create_pokepaste

从宝可梦配招对象数组创建一个宝可梦配招表。

参数:

  • pokemon(数组,必需):宝可梦配招对象数组
  • title(字符串,可选):配招表标题
  • author(字符串,可选):作者姓名
  • notes(字符串,可选):附加说明

宝可梦配招对象结构:

{
  "name": "string",
  "species": "string", 
  "item": "string",
  "ability": "string",
  "moves": ["string", "string", "string", "string"],
  "nature": "string",
  "gender": "string",
  "evs": {
    "hp": 0,
    "atk": 252,
    "def": 0,
    "spa": 4,
    "spd": 0,
    "spe": 252
  },
  "ivs": {
    "hp": 31,
    "atk": 31,
    "def": 31,
    "spa": 31,
    "spd": 31,
    "spe": 31
  },
  "level": 50,
  "shiny": false,
  "happiness": 255,
  "pokeball": "Poke Ball",
  "hpType": "Electric",
  "dynamaxLevel": 10,
  "gigantamax": false,
  "teraType": "Electric"
}

使用示例:

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50
    }
  ],
  "title": "My Team",
  "author": "Trainer"
}

高级用法

MCP客户端配置

配置你的MCP客户端(Claude Desktop、Cursor等):

使用远程npm包:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "npx",
      "args": ["pokemon-paste-mcp"],
      "env": {}
    }
  }
}

本地开发:

{
  "mcpServers": {
    "pokemon-paste": {
      "command": "node",
      "args": ["/path/to/pokemon-paste-mcp/dist/index.js"],
      "env": {}
    }
  }
}

📚 详细文档

测试

本地MCP工具测试

你可以使用MCP检查器测试本地MCP服务器:

npm run build
npx @modelcontextprotocol/inspector node path/to/pokemon-paste-mcp/dist/index.js

如果你想直接使用MCP客户端测试MCP服务器,可以使用以下完整测试输入:

{
  "pokemon": [
    {
      "name": "Pikachu",
      "species": "Pikachu",
      "item": "Light Ball",
      "ability": "Static",
      "moves": ["Thunderbolt", "Quick Attack", "Iron Tail", "Agility"],
      "nature": "Jolly",
      "gender": "M",
      "evs": { "hp": 0, "atk": 252, "def": 0, "spa": 4, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 31, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": false
    },
    {
      "name": "Charizard",
      "species": "Charizard",
      "item": "Charcoal",
      "ability": "Blaze",
      "moves": ["Flamethrower", "Air Slash", "Solar Beam", "Roost"],
      "nature": "Modest",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "teraType": "Fire"
    },
    {
      "name": "Alakazam",
      "species": "Alakazam",
      "item": "Life Orb",
      "ability": "Magic Guard",
      "moves": ["Psychic", "Focus Blast", "Shadow Ball", "Recover"],
      "nature": "Timid",
      "gender": "M",
      "evs": { "hp": 4, "atk": 0, "def": 0, "spa": 252, "spd": 0, "spe": 252 },
      "ivs": { "hp": 31, "atk": 0, "def": 31, "spa": 31, "spd": 31, "spe": 31 },
      "level": 50,
      "shiny": true,
      "pokeball": "Ultra Ball"
    }
  ],
  "title": "Sample Competitive Team",
  "author": "Pokemon Trainer",
  "notes": "A balanced team with Pikachu as the main attacker, Charizard for coverage, and Alakazam for special sweeping."
}

这个测试输入包括:

  • 三只不同角色的宝可梦
  • 各种可选字段(闪光、太晶属性、精灵球)
  • 竞技对战的样本努力值/个体值分配
  • 团队元数据(标题、作者、说明)

预期输出应该是一个宝可梦配招表URL,你可以访问该URL查看格式化后的团队。

📄 许可证

本项目采用MIT许可证。

💬 作者说明

如果你对本项目的进展感兴趣,欢迎关注该仓库以获取实时更新!

如果你需要就本项目联系我,可以通过以下方式:

  • 发送邮件至 professor.ragna@gmail.com
  • 在Twitter上联系我 @professorragna

如果你有兴趣资助本项目,可以 点击这里 支持我。非常感谢你的支持!

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端