Blue Archive MCP Server

Blue Archive MCP Server

A Model Context Protocol (MCP) server that provides comprehensive access to Blue Archive game data, including student information, equipment, stages, items, and more.

Overview

The Blue Archive MCP Server integrates with the SchaleDB API to provide AI assistants with real-time access to Blue Archive game data. This server implements the Model Context Protocol, enabling seamless integration with MCP-compatible clients like Claude Desktop.

Key Capabilities

• Student Database: Access detailed information about all Blue Archive students
• Equipment & Items: Browse weapons, equipment, and consumable items
• Stage Information: Get details about campaign stages and raids
• Multimedia Content: Retrieve student avatars and voice clips
• Advanced Search: Filter and search across all data types
• Multi-language Support: Available in Chinese, Japanese, and English

Features

• ✅ 8 Comprehensive Tools for accessing game data
• 🌐 Multi-language Support (CN/JP/EN)
• 🔍 Advanced Filtering and search capabilities
• 🖼️ Rich Media Integration (avatars, voice clips)
• ⚡ Performance Optimized with caching
• 🛡️ Error Handling and retry mechanisms
• 📱 Responsive Data Formatting (text/markdown)

Installation

Prerequisites

• Node.js 18+
• npm or yarn package manager
• MCP-compatible client (e.g., Claude Desktop)

Method 1: NPM Installation (Recommended)

Install directly from NPM:

npm install -g blue-archive-mcp

Or install locally in your project:

npm install blue-archive-mcp

Method 2: From Source

1. Clone the repository

   git clone <repository-url>
   cd blue_archive_mcp
   

2. Install dependencies

   npm install
   

3. Build the project

   npm run build
   

4. Test the server

   npm start
   

Configuration

Claude Desktop Integration

Add the following configuration to your Claude Desktop config file:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

For NPM Installation:

{
  "mcpServers": {
    "blue-archive": {
      "command": "npx",
      "args": ["blue-archive-mcp"]
    }
  }
}

For Source Installation:

{
  "mcpServers": {
    "blue-archive": {
      "command": "node",
      "args": ["path/to/blue_archive_mcp/dist/index.js"]
    }
  }
}

Environment Variables

Available Tools

1. get_students

Retrieve student information with filtering options.

Parameters:

• language (string, optional): Language preference (cn/jp/en) - Default: "cn"
• search (string, optional): Search by student name
• limit (number, optional): Maximum results - Default: 20
• detailed (boolean, optional): Include detailed stats - Default: false
• school (string, optional): Filter by school
• starGrade (number, optional): Filter by star grade (1-3)
• role (string, optional): Filter by tactical role

2. get_student_info

Get detailed information for a specific student.

Parameters:

• studentId (number, required): Student's unique ID
• language (string, optional): Language preference - Default: "cn"

3. get_student_by_name

Find student by name (supports multiple languages).

Parameters:

• name (string, required): Student name in any supported language
• language (string, optional): Response language - Default: "cn"
• detailed (boolean, optional): Include detailed information - Default: false

4. get_raids

Retrieve raid information and boss data.

Parameters:

• language (string, optional): Language preference - Default: "cn"
• search (string, optional): Search by raid name
• detailed (boolean, optional): Include detailed stats - Default: false

5. get_equipment

Browse equipment and weapon data.

Parameters:

• language (string, optional): Language preference - Default: "cn"
• category (string, optional): Equipment category filter
• tier (number, optional): Equipment tier (1-7)
• limit (number, optional): Maximum results - Default: 20
• detailed (boolean, optional): Include detailed stats - Default: false

6. get_stages

Access campaign and stage information.

Parameters:

• language (string, optional): Language preference - Default: "cn"
• search (string, optional): Search by stage name
• area (string, optional): Filter by area