MCMod MCP Server — Setup & Usage Guide

1. Setup on Server (192.168.1.248)

# 1. Copy the MCMod folder to your server or clone it
# 2. Navigate to the mcp-server directory
cd /path/to/MCMod/mcp-server

# 3. Install dependencies
npm install

# 4. Create your .env file (DO NOT share this file)
cp .env.example .env
nano .env   # or use any text editor

Inside .env, fill in:

SERVER_HOST=0.0.0.0
SERVER_PORT=3001
MCP_API_KEY=your_random_secret_key
MOD_DATA_ROOT=/path/to/MCMod

Generate a random API key:

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# 5. Start the server
npm start

The server will be available at: http://192.168.1.248:3001

---

2. Connect from Gemini CLI

Add to your Gemini CLI config (~/.gemini/config.json or settings.json):

{
  "mcpServers": {
    "mcmod": {
      "transport": "sse",
      "url": "http://192.168.1.248:3001/sse",
      "headers": {
        "x-api-key": "your_api_key_here"
      }
    }
  }
}

---

3. Connect from Claude CLI

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "mcmod": {
      "transport": "sse",
      "url": "http://192.168.1.248:3001/sse",
      "headers": {
        "x-api-key": "your_api_key_here"
      }
    }
  }
}

---

4. Connect from Codex CLI (OpenAI)

Add to your Codex CLI config:

{
  "mcp_servers": [
    {
      "name": "mcmod",
      "transport": "sse",
      "url": "http://192.168.1.248:3001/sse",
      "headers": {
        "x-api-key": "your_api_key_here"
      }
    }
  ]
}

---

5. Available MCP Tools

Tool	Description
list_classes	List all classes (Wizard, Ninja)
list_skills	List skills by class + tree (Main/Succession/Awakening)
get_skill	Get full skill data by ID or name
search_skills	Search by CC type, special damage, keyword
get_skill_icon	Get pixel icon as base64 PNG
get_world_core	Get combat ruleset (stats/offensive/special/defensive)

---

6. Quick Test (curl)

# Health check
curl http://192.168.1.248:3001/

# Direct tool call (no SSE, just REST)
curl -X POST http://192.168.1.248:3001/call/get_skill \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{"id": "wizard_fireball"}'

# Search by CC effect
curl -X POST http://192.168.1.248:3001/call/search_skills \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{"cc_effect": "Floating", "class": "Ninja"}'

# Get World Core
curl -X POST http://192.168.1.248:3001/call/get_world_core \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{"section": "offensive"}'

---

7. Auto-start on Boot (Linux systemd)

# Create service file
sudo nano /etc/systemd/system/mcmod-mcp.service

[Unit]
Description=MCMod MCP Server
After=network.target

[Service]
Type=simple
User=kanfullbuster
WorkingDirectory=/home/kanfullbuster/MCMod/mcp-server
ExecStart=/usr/bin/node server.js
Restart=on-failure
EnvironmentFile=/home/kanfullbuster/MCMod/mcp-server/.env

[Install]
WantedBy=multi-user.target

sudo systemctl enable mcmod-mcp
sudo systemctl start mcmod-mcp
sudo systemctl status mcmod-mcp