🔌 MCP Plugin Usage Guide

Model Context Protocol (MCP) is a communication framework designed specifically for large language models to establish a standardized information exchange mechanism between the model and the external environment. It provides the following core functions:

Function	Description
🧠 Context Management	Efficiently manages and transmits the context information required by the model
🔄 Capability Expansion	Allows for flexible expansion of model capabilities through standardized interfaces
🔒 Consistency Guarantee	Ensures the reliability and stability of communication between the model and the external environment
🛠️ Tool Integration	Supports seamless integration with various development tools and services

⚙️ Configuration and Usage

🔧 Supported Development Tools

🔍 Compatible Tools: Several mainstream development tools now fully support the MCP protocol:

• VS Code
• Trae
• Claude
• Cursor
• Windsurf
• Cline
• Cherry Studio, etc.

📝 VS Code Configuration Steps

1. Create an mcp.json configuration file in the .vscode directory of your project.
2. Add the following configuration content:

{
  "servers": {
    "ArenaPro-MCP": {
      "type": "sse",
      "url": "http://localhost:25315/ap-mcp"
    }
  }
}

📋 Configuration Description:

• servers: A collection of MCP server configurations
• ArenaPro-MCP: The server identifier name (can be customized)
• type: The service type, using the SSE (Server-Sent Events) protocol
• url: The MCP server address

🚀 Starting the Service

After completing the configuration, the interface will be displayed as follows:

Figure 1: MCP Configuration Interface

Click the run button above the configuration button and wait for the service to start before you can begin using it.

💬 Feature Usage

🤖 AI Agent Interaction

1. Start the built-in GitHub Copilot in VS Code
2. Switch to Agent mode

Figure 2: Agent Mode Settings Interface

🧩 Extended Tool Integration

🔌 Integrated Tools: The core MCP functions provided by the plugin can work in conjunction with other MCP tools to access more Box3-related features:

• Box3 Engine OpenAPI
• Box3 Map Data Analysis

📊 Application Examples

📝 Code Inspection and Deployment

The AI can assist in checking code issues and automatically deploying to Box3 via MCP:

Figure 3: Code Inspection and Deployment Example

📈 Map Data Analysis

Combined with the Box3 map data analysis tool, the following automated tasks can be achieved:

Function	Description
🔑 User Authorization Acquisition	Automatically obtains user authorization and map information
📊 Data Analysis	Analyzes gameplay data and generates various statistical results
📝 Report Generation	Generates structured analysis reports
🔄 Document Updates	Automatically updates relevant documents

Figure 4: Map Data Analysis Example

⚡ Automation Advantages

🔑 Seamless Authorization

• Eliminates manual account entry
• AI directly accesses account data

🔄 Tool Collaboration

• Supports multi-tool collaborative analysis
• Enables automated operation flows

Figure 5: Automated Operation Flow

❓ Frequently Asked Questions

Issue	Solution
🚫 Service Fails to Start	• Check if port 25315 is occupied • Confirm the plugin's enabled status • Try restarting VS Code
🔌 Tool Connection Abnormal	• Verify the network connection status • Check the tool's service address configuration • Confirm firewall settings

Warning

⚠️ Note: Service startup depends on the ArenaPro plugin. Please ensure it is correctly installed and enabled. If you encounter network issues, it is recommended to check your network connection and try using a proxy or switching to a different network environment.

📚 Appendix: MCP Tool Commands

👤 User Center Tools

Command	Description
userCenterTool_userTokenAndUA	Get user Token and UserAgent
userCenterTool_userInfo	Get basic user information
userCenterTool_accountsLogin	Account login
userCenterTool_accountsLogout	Account logout

📁 File Operation Tools

Command	Description
file_npm_package_get	Search for Box3 NPM packages
file_outputName	Output and update file
file_mapTool	Map selection
file_buildNUpload	Build and upload
file_createProject	Create project
file_checkDts	Check Dts files
file_nodeJs_setting	Node.js configuration
file_openArena	Open resource manager
file_reHMR	Restart HMR
file_stopHMR	Stop HMR
file_upLoad	Upload JS file
file_debugger	Quick debug
file_openOutputLog	Open output log
file_dao3config_open	Open project configuration
file_npm_package_path	Set NPM package path

🗺️ Map Tools

Command	Description
map_showMap	Show map creator end
map_playData	View gameplay data
map_resource	Sync map resources

🧩 Component Tools

Command	Description
component_showComponentStats	Show component stats

💬 Chat 吉 PT Tools

| Command | Description |