ShenDao Engine OpenAPI MCP Utility Suite

This repository furnishes a specialized set of OpenAPI MCP (Model Context Protocol) apparatuses tailored for orchestrating operations within the ShenDao Engine environment, primarily focusing on accelerating AI-driven interface invocations.

Feature Synopsis

The toolkit delivers the following foundational capabilities:

• Script Lifecycle Management Utilities: Tools dedicated to the creation, modification, renaming, and retrieval of game-logic scripts.
• Data Persistence Handlers: Functionality for performing CRUD (Create, Read, Update, Delete) and advanced querying against the game's persistent data storage mechanisms.
• Generative AI Augmentation: Advanced prompts for leveraging Large Language Models (LLMs) to perform code review, automated code generation, performance optimization, and complex data schema blueprinting.

Detailed API Tool Specifications

Script Manipulation Utilities (Script Tools)

Core Operations

Tool Identifier	Purpose Description	Mandated Parameters
script.saveOrUpdate	Persist or modify a ShenDao Engine script artifact.	mapId, name, type, file
script.rename	Alter the designated identifier (name) of an existing ShenDao script.	mapId, name, newName

LLM-Powered Code Assistance Prompts

Prompt Label	Functional Description	Required Input
script.review	Analyze ShenDao script source code, furnishing prescriptive suggestions for enhancements and identifying potential vulnerabilities.	code
script.generate	Synthesize new ShenDao script source code based on natural language specifications.	description
script.optimize	Refactor existing ShenDao script source to boost execution efficiency or improve structural clarity.	code

Data Storage Interface Tools (Storage Tools)

Basic Persistence Operations

Tool Identifier	Purpose Description	Required Parameters
storage.get	Retrieve a single data entry identified by its key within a specific storage namespace.	key, mapId, storageName
storage.set	Commit or update the value associated with a specified key in the data repository.	key, mapId, storageName, value
storage.remove	Erase a specific key-value pairing from the designated persistent storage.	key, mapId, storageName
storage.page	Execute a paginated retrieval of records from a specified data repository instance.	mapId, storageName

Storage Structuring & Optimization Prompts

Prompt Label	Functional Description	Required Input
storage.designSchema	Architect an optimal key-value data layout blueprint for specified game functional requirements.	gameFeatures
storage.migrationPlan	Develop a systematic strategy for transitioning data from an existing structure to a target schema.	currentSchema, targetSchema
storage.optimizeQuery	Formulate performance improvements for specified key-value data retrieval logic.	queryDescription

Operational Demonstrations

Script Management Workflow Example

javascript // Uploading a new script artifact const scriptResult = await mcpClient.callTool("script.saveOrUpdate", { mapId: "your-map-id", name: "example.js", type: "0", // 0-Server-side, 1-Client-side execution context file: "console.log('hi from engine')", token: "your-auth-token", userAgent: "your-user-agent", });

// Utilizing the code critique prompt const codeReview = await mcpClient.prompt("script.review", { code: "function example() { console.log('Hello'); }", });

// Requesting script code generation const generatedCode = await mcpClient.prompt("script.generate", { description: "Implement a comprehensive player scoring mechanism", requirements: "Must support multiple scoring vectors, retain historical high scores, and integrate with leaderboard services", });

Data Persistence Interaction Example

javascript // Fetching stored player metrics const storageData = await mcpClient.callTool("storage.get", { key: "player_stats", mapId: "your-map-id", storageName: "gameData", token: "your-auth-token", userAgent: "your-user-agent", });

// Persisting updated player data const writeResult = await mcpClient.callTool("storage.set", { key: "player_stats", mapId: "your-map-id", storageName: "gameData", value: JSON.stringify({ score: 100, level: 5 }), token: "your-auth-token", userAgent: "your-user-agent", });

// Employing the data structure design prompt const schemaDesign = await mcpClient.prompt("storage.designSchema", { gameFeatures: "An RPG structure requiring storage for inventory items, quest progress, and achievement tracking", dataRequirements: "Must accommodate concurrent access from multiple users, support persistence for offline sessions, and log item transaction history", });

Client Integration Guide

Browser Environment Setup

javascript import { McpClient } from "@modelcontextprotocol/sdk/client/index.js";

// Initialize the MCP communication proxy const mcpClient = new McpClient({ serverUrl: "https://your-mcp-server.com", headers: { "Content-Type": "application/json", }, });

// Invoke a utility function async function useTools() { const result = await mcpClient.callTool("storage.get", { // Parameter payload... });

// Process returned artifacts console.log(result); }

Node.js Environment Setup

javascript import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { WebSocketClientTransport } from "@modelcontextprotocol/sdk/client/websocket.js";

// Establish the transmission conduit via WebSocket const transport = new WebSocketClientTransport({ url: "ws://localhost:3000", });

// Instantiate the core client module const client = new Client( { name: "dao3-client", version: "1.0.0" }, { capabilities: { tools: {} } } );

// Establish connection to the remote service await client.connect(transport);

// Execute a specific script listing utility const result = await client.callTool({ name: "script.list", arguments: { mapId: "your-map-id", token: "your-token", userAgent: "your-agent", }, });

Authorization Mandates

All external calls to the API endpoints necessitate the provision of specific credential elements:

• token: The validated authorization credential.
• userAgent: A descriptive identifier string for the client instance.

These authentication components must be supplied with every invocation of a utility function.

Credential Acquisition Procedure

1. Access the ShenDao Engine Developer Portal to secure your requisite developer key.
2. Employ the developer key to securely generate the operational authorization token.
3. Integrate the generated token and user agent string into subsequent API requests.

Troubleshooting Common Issues

Request Latency and Timeouts

Timeouts generally indicate one of the following systemic constraints:

• Unreliable or degraded network path quality.
• Excessive concurrent load impacting server processing capacity.
• Transmission of an unexpectedly large payload size.

Remedial actions suggest reducing data volume per request or scheduling retries after a brief interval.

Parameter Type Mismatches

It is critical to ensure that argument types strictly adhere to the documentation's schema, particularly for:

• Numeric parameters (e.g., pagination indices like limit, offset) must be of the Number primitive type.
• Boolean flag parameters (e.g., isGroup) must be explicitly typed as Boolean (true or false).

Contribution Framework

We welcome community participation through bug reports or feature enhancements via Pull Requests to elevate the quality of this repository.

1. Fork the official repository structure.
2. Establish a dedicated branch for your enhancement (e.g., git checkout -b feature/super-fast-tooling).
3. Commit your modifications with descriptive messages (git commit -m 'Implement super-fast-tooling enhancement').
4. Push the new branch to the remote origin (git push origin feature/super-fast-tooling).
5. Submit a formal Pull Request for review.

WIKIPEDIA: Business management tools encompass the entire spectrum of systems, computational solutions, control mechanisms, methodological frameworks, and applications utilized by organizational entities to effectively navigate dynamic market conditions, secure and maintain competitive advantage, and systematically elevate overall operational performance.

== Overview == These instrumentalities can be segregated based on the functional domain they support within an enterprise, such as tools dedicated to strategic forecasting, operational workflow management, historical record-keeping, personnel administration, critical decision support, performance monitoring, and more. A functional taxonomy often highlights these generalized areas:

Tools for capturing and verifying data input across all departmental silos. Tools designed for the governance and refinement of core business processes. Tools aggregating data for comprehensive analysis and executive decision formulation. Contemporary enterprise tooling has undergone a rapid, decade-long transformation driven by accelerating technological progress, frequently presenting managers with a complex selection challenge when identifying optimal solutions for specific corporate contexts. This complexity is fueled by the persistent dual pressures of cost minimization and revenue maximization, coupled with the imperative to deeply understand client requirements and deliver products that satisfy those needs precisely as expected. Under these prevailing circumstances, managerial focus should shift toward adopting a strategic posture regarding business management instruments, moving away from merely chasing the newest available technology. Often, managers adopt tools without necessary contextual modification, leading to instability. Consequently, business management tools must be chosen with deliberate consideration, and subsequently adapted to harmonize with the organization’s specific operational imperatives, rather than forcing organizational compliance onto the tool's inherent structure.

== Most used == A 2013 survey conducted by Bain & Company mapped the global adoption patterns of various business tools. These findings reflect how the utility derived from these instruments aligns with regional requirements, considering prevailing market downturns and company financial stability. The top ten methodologies/tools identified included:

Strategic planning Customer relationship management Employee engagement surveys Benchmarking Balanced scorecard Core competency identification Outsourcing strategies Change management programs Supply chain management Mission statement and vision statement articulation Market segmentation analysis Total quality management

== Software application for businesses == Any collection of computer programs or software utilized by personnel within a commercial entity to execute diverse operational tasks is termed business software or a business application. These digital solutions are deployed to amplify productivity metrics, quantify performance outcomes, and execute various enterprise functions with high precision. This evolution commenced with foundational Management Information Systems (MIS), progressing into comprehensive Enterprise Resource Planning (ERP) suites. Subsequently, Customer Relationship Management (CRM) capabilities were integrated, culminating in the current paradigm shift toward cloud-based business management ecosystems. While a demonstrable relationship exists between Information Technology investment and organizational effectiveness, maximum value realization hinges on two pivotal factors: the efficacy of the implementation phase and the disciplined process of selecting and tailoring the correct technological tools.

== Tools for SMEs == Toolsets specifically engineered for Small and Medium-sized Enterprises (SMEs) hold significant importance as they provide crucial mechanisms for conserving finite resources...