NetStone.MCP

MCP Toolset for FFXIV Lodestone — Integrates NetStone into a natural-language-capable MCP server for querying character and world data from Final Fantasy XIV.

Overview

This project transforms FFXIV Lodestone API library NetStone, along with other external APIs, into a set of Model Context Protocol (MCP) tools. It enables users to query Lodestone and related game data using natural language prompts through any MCP-compatible LLM client such as OpenAI or Claude.

Data Source

• NetStone
• FFXIV_PaissaHouse
• FFXIVStore
• XIVAPI
• FFXIV Lodestone News
• Thaliak

Setup

Setup

Sample

• Claude Desktop

• Custom Console

• Custom WPF

Features

• Character search — Search for FFXIV characters by name and world.
• Character profile details — Fetch detailed character profiles.
• Free Company search — Search for Free Companies by name and server.
• Free Company profile details — Retrieve Free Company members and data.
• World list — List all supported FFXIV worlds.
• House list — List all purchasable houses.
• Store list — List store categories.
• search for products by specifying a category name.

Quick Setup - Docker for Discord Bot

1. Create a .env file in the project root and add your keys:

   OPENAI_API_KEY=your_openai_api_key
   DISCORD_BOT_KEY=your_discord_bot_token

2. Build the Docker image:

   docker build -f ./dockerfile -t netstone-mcp .

3. Start the container with Docker Compose

   docker compose up -d

Make sure the .env file is in the same directory as your docker-compose.yml.