Reservation System

This MCP server provides a WeChat Cloud-based reservation API that lets you securely access, query, and manage reservation data through a structured MCP interface. You can query reservations, update their status, and permanently delete records, all while keeping sensitive credentials protected via environment variables.

How to use

You will integrate this server with your MCP client to perform common reservation operations. Use the provided runtime command to start the local MCP server, then configure your MCP client to connect to it as shown in the configuration examples. Once connected, you can query reservations by user, status, or meet IDs, update statuses (including cancelations with optional reasons), and permanently delete records when needed. All actions are logged for auditing and you should manage access to trusted clients only.

Key actions you can perform through the MCP server include querying reservations, updating reservation status (cancel, resume, system cancel), and deleting reservations. Ensure you understand the impact of each operation, especially the irreversible delete action.

Configuration of your MCP client is done by adding a reservation MCP server entry that points to a local stdio-based server process. You will run the server locally and reference its executable with the MCP launcher in your client configuration.

How to install

Prerequisites: Node.js and npm should be installed on your system. You also need a WeChat Cloud environment and credentials for API access.

# 1) Install dependencies for the MCP server
cd mcp-reservation-server
npm install

# 2) Configure environment variables
cp .env.example .env
# Edit .env and fill in your credentials:
# WECHAT_APP_ID, WECHAT_APP_SECRET, WECHAT_ENV_ID

3. Build the project to generate the runtime artifacts.

npm run build

4. Start the server in normal (production) mode or in development mode as needed.

# Production start
npm start

# Development mode
npm run dev

Configuration and usage notes

When you configure your MCP client, include the local stdio-based server command and the path to the built entry point. The example configuration below shows how to point the client to a locally running server.

{
  "mcpServers": {
    "reservation": {
      "command": "node",
      "args": ["/path/to/mcp-reservation-server/dist/index.js"],
      "env": {
        "WECHAT_APP_ID": "你的AppID",
        "WECHAT_APP_SECRET": "你的Secret",
        "WECHAT_ENV_ID": "你的环境ID"
      }
    }
  }
}

Security and operational notes

Protect sensitive information by using environment variables rather than hardcoding credentials. Ensure that only trusted MCP clients can access the server. The server logs all API calls for auditing, and be cautious with irreversible actions like permanent deletions.

Usage examples with AI clients

Use the MCP configuration above in your AI client to perform operations such as querying reservations, canceling or resuming bookings, and deleting records. Ensure your client handles token refresh and error codes returned by the underlying WeChat Cloud APIs.

Tips for deployment

If you are deploying the server, consider running it behind a controlled environment and limit access to your MCP clients. Regularly back up important data and monitor for any unexpected API activity.

Available tools

query_reservations

Query reservation records with optional filters such as user ID, status, and meet/project ID, with a limit on the number of returned records and formatted results.

update_reservation_status

Update the status of a reservation, including cancel (10), restore (1), and system cancel (99). You can optionally provide a cancellation reason.

delete_reservation

Permanently delete a reservation record; this operation is non-reversible and should be used with caution.