https://github.com/dks50217/NetStoneMCP

MCP tools for FFXIV using NetStone and external APIs via LLMs.
https://github.com/dks50217/NetStoneMCP

Last synced: about 2 months ago
JSON representation

MCP tools for FFXIV using NetStone and external APIs via LLMs.

• Host: GitHub
• URL: https://github.com/dks50217/NetStoneMCP
• Owner: dks50217
• License: mit
• Created: 2025-05-05T05:45:34.000Z (6 months ago)
• Default Branch: main
• Last Pushed: 2025-08-23T15:54:36.000Z (2 months ago)
• Last Synced: 2025-08-24T06:01:47.868Z (2 months ago)
• Language: C#
• Homepage:
• Size: 1.58 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-servers - **NetStoneMCP** - MCP tools for FFXIV using NetStone and external APIs via LLMs. `c#` `mcp` `api` `llm` `git clone https://github.com/dks50217/NetStoneMCP` (🔌 API)
• awesome-mcp-servers - **NetStoneMCP** - MCP tools for FFXIV using NetStone and external APIs via LLMs. `c#` `mcp` `api` `llm` `git clone https://github.com/dks50217/NetStoneMCP` (API)

README

          
# NetStone.MCP

[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/dks50217/NetStoneMCP)

MCP Toolset for FFXIV Lodestone — Integrates [NetStone](https://github.com/xivapi/NetStone) into a natural-language-capable MCP server for querying character and world data from Final Fantasy XIV.

[![Not By AI](./docs/Produced-By-Human-Not-By-AI-Badge-white.png)](https://notbyai.fyi/hi/not-by-ai/)

## 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](https://github.com/xivapi/NetStone)

* [FFXIV_PaissaHouse](https://github.com/zhudotexe/FFXIV_PaissaHouse)

* [FFXIVStore](https://store.finalfantasyxiv.com/ffxivstore/en-us/)

* [XIVAPI](https://github.com/xivapi)

* [FFXIV Lodestone News](https://lodestonenews.com/)

* [Thaliak](https://thaliak.xiv.dev/)

## Setup

[Setup](./sample/README.md)

## Sample

* Claude Desktop

![sample5](./docs/sample5.png)




* Custom Console




![sample](./docs/sample.png)




* Custom WPF




![sample3](./docs/sample3.png)




![sample4](./docs/sample4.png)

## Features

- [x] Character search — Search for FFXIV characters by name and world.

- [x] Character profile details — Fetch detailed character profiles.

- [x] Free Company search — Search for Free Companies by name and server.

- [x] Free Company profile details — Retrieve Free Company members and data.

- [x] World list — List all supported FFXIV worlds.

- [x] House list — List all purchasable houses.

- [x] Store list — List store categories. 

- [x] 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:

    ```env

    OPENAI_API_KEY=your_openai_api_key

    DISCORD_BOT_KEY=your_discord_bot_token

    ```

2. Build the Docker image:

    ```sh

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

    ```

3. Start the container with Docker Compose

    ```sh

    docker compose up -d

    ```

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