关键词

探路者 第二版TTRPG 数据游戏规则查询物品制造宝藏生成

项目简介

Pathfinder-MCP 是一个实现了 Model Context Protocol (MCP) 标准的服务器应用。它充当 AI 助手（如支持 MCP 的 Claude）与《探路者 第二版》游戏数据源 Archives of Nethys (AON) 之间的桥梁。通过连接到此服务器，AI 助手可以获取最新的游戏规则、法术、物品、生物等信息，从而提供更准确、更有用的游戏辅助。

主要功能点

本服务器向连接的 MCP 客户端（如 AI 助手）提供以下核心功能：

  • 游戏内容搜索： 允许 AI 助手在《探路者 第二版》的 21 个不同类别（包括法术、专长、职业、物品、生物等）中搜索特定内容。
  • 详细信息获取： 使 AI 助手能够通过名称和类别查找并检索特定游戏元素的详细信息。
  • 类别项目列表： 提供分页功能，允许 AI 助手获取某个游戏类别下的所有项目列表。
  • 宝藏预算生成： 根据党派等级、人数和战役类型（如沙盒）计算建议的宝藏预算。
  • 物品制造需求计算： 根据角色等级、熟练度、专长等因素，计算特定物品的制造（Crafting）所需材料、时间、DC 和可能结果。

安装步骤

要运行 Pathfinder-MCP 服务器，您需要先安装 Node.js (v18 或更高版本)。

  1. 克隆仓库： 打开终端或命令提示符，执行以下命令下载项目代码： 
    git clone https://github.com/HeatherFlux/Pathfinder-MCP.git
cd Pathfinder-MCP
  2. 安装依赖： 进入项目目录后，使用 npm, yarn 或 pnpm 安装所需的库： 
    npm install
# 或 yarn install
# 或 pnpm install
  3. 构建项目： 构建 TypeScript 代码： 
    npm run build
# 或 yarn build
# 或 pnpm build

服务器配置

Pathfinder-MCP 服务器设计为通过 Stdio 传输协议与 MCP 客户端通信。要让您的 MCP 客户端（例如 Claude Desktop）连接到此服务器，您需要在客户端的 MCP 设置中添加一个服务器配置。

您需要配置的主要信息包括：

  • 服务器名称 (Server Name): 用于客户端识别此服务器的唯一名称。该服务器定义的名称是 'pathfinder-mcp'。
  • 命令 (Command): 启动服务器可执行文件的命令。在大多数系统上，构建后的 Node.js 应用使用 'node' 命令执行。
  • 参数 (Args): 传递给命令的参数列表。通常是服务器主程序的路径。构建后，主程序文件位于项目的 'dist' 目录下，路径通常是 'dist/index.js'。您需要提供指向您本地克隆的 Pathfinder-MCP 仓库中 'dist/index.js' 文件的完整路径。
  • 传输协议 (Transport): 客户端与服务器通信的方式。此服务器使用 'stdio' 协议。

具体的配置过程和界面取决于您使用的 MCP 客户端软件。请参考您客户端的文档进行配置。例如，对于某些客户端，您可能需要在设置中添加一个 JSON 配置项，其中包含上述信息。

基本使用方法

配置并启动服务器后，AI 助手即可利用其提供的能力。您无需直接与服务器命令行交互，而是通过与 AI 助手进行自然语言对话来使用这些功能。

例如，您可以向 AI 助手提问：

  • “告诉我《探路者 第二版》中火球术（Fireball）的信息。”
  • “战士职业（Fighter class）有哪些能力？”
  • “解释一下强力打击（Power Attack）专长。”
  • “计算一下为四个 7 级角色生成宝藏预算。”
  • “计算一下制造一把+1长剑（+1 Longsword）所需的材料和时间，假设我的角色是 5 级，熟练度为专家。”

AI 助手会识别您的意图，调用 Pathfinder-MCP 服务器上的相应工具获取数据，然后以自然语言的形式将结果呈现给您。

信息

分类

AI与计算

访问项目