Reservation System MCP Server

Se integra con la API del sistema de reservas de desarrollo en la nube de WeChat.

Documentación

Servidor MCP del Sistema de Reservas

Este es un servidor API del sistema de reservas basado en WeChat Cloud Development y el Protocolo de Contexto de Modelo (MCP), que permite a los modelos de IA acceder y gestionar datos de reservas de forma segura.

Características

🔧 Herramientas compatibles

query_reservations - Consultar registros de reservas
- Admite filtrado por ID de usuario, estado e ID del proyecto de reserva
- Permite establecer un límite en el número de registros devueltos
- Devuelve información de reserva formateada
update_reservation_status - Actualizar estado de reserva
- Cancelar reserva (establecer estado en 10)
- Restaurar reserva (establecer estado en 1)
- Cancelación del sistema (establecer estado en 99)
- Se puede añadir un motivo de cancelación
delete_reservation - Eliminar registro de reserva
- Elimina permanentemente el registro de reserva especificado
- Operación irreversible, usar con precaución

📊 Descripción de estados de reserva

1 - ✅ Reserva exitosa
10 - ❌ Cancelada
99 - ⚠️ Cancelación del sistema

Instalación y configuración

1. Instalar dependencias

cd mcp-reservation-server
npm install

2. Configurar variables de entorno

Copie el archivo de ejemplo de variables de entorno y configúrelo:

cp .env.example .env

Edite el archivo .env:

WECHAT_APP_ID=你的微信小程序AppID
WECHAT_APP_SECRET=你的微信小程序Secret
WECHAT_ENV_ID=你的微信云环境ID

3. Compilar el proyecto

npm run build

4. Iniciar el servidor

npm start

O modo de desarrollo:

npm run dev

Uso en clientes de IA

Configurar el cliente MCP

Agregue este servidor MCP en el archivo de configuración de su cliente de IA:

{
  "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"
      }
    }
  }
}

Ejemplo de configuración de Claude Desktop

{
  "mcpServers": {
    "reservation": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-reservation-server\\dist\\index.js"],
      "env": {
        "WECHAT_APP_ID": "",
        "WECHAT_APP_SECRET": "",
        "WECHAT_ENV_ID": ""
      }
    }
  }
}

Ejemplos de uso

Consultar registros de reserva

请查询所有状态为成功的预约记录

Cancelar reserva

请取消预约ID为 JOIN123456 的预约，理由是"用户主动取消"

Eliminar reserva

请永久删除预约ID为 JOIN123456 的记录

Referencia de API

Puntos finales de la API de WeChat Cloud Development

Este servidor MCP utiliza las siguientes API de WeChat Cloud Development:

Obtener Access Token: GET https://api.weixin.qq.com/cgi-bin/token
Consulta de base de datos: POST https://api.weixin.qq.com/tcb/databasequery
Actualización de base de datos: POST https://api.weixin.qq.com/tcb/databaseupdate
Eliminación de base de datos: POST https://api.weixin.qq.com/tcb/databasedelete

Colecciones de base de datos

ax_join: Tabla de registros de reservas
- JOIN_ID: ID del registro de reserva
- JOIN_USER_ID: ID de usuario
- JOIN_MEET_ID: ID del proyecto de reserva
- JOIN_MEET_TITLE: Título del proyecto de reserva
- JOIN_STATUS: Estado de la reserva
- JOIN_REASON: Motivo de cancelación
- Otros campos...

Consideraciones de seguridad

Protección de variables de entorno: Asegúrese de que la información sensible como el AppSecret de WeChat se configure mediante variables de entorno, no la codifique en el código.
Permisos de acceso: Asegúrese de que solo clientes de IA de confianza puedan acceder a este servidor MCP.
Registro de operaciones: El servidor registra todas las llamadas a la API para facilitar la auditoría.
Copia de seguridad de datos: La operación de eliminación es irreversible, se recomienda realizar copias de seguridad periódicas de los datos importantes.

Solución de problemas

Errores comunes

AccessToken no válido (40014)
- Verifique que AppID y AppSecret sean correctos
- Confirme la configuración de la lista blanca de IP
AccessToken caducado (42001)
- El servidor actualiza automáticamente el token; si persiste, verifique la hora del sistema.
Error en la consulta de base de datos
- Verifique que el ID del entorno en la nube sea correcto
- Confirme que la colección de la base de datos exista

Modo de depuración

Configure la variable de entorno para habilitar los registros de depuración:

LOG_LEVEL=debug npm start

Desarrollo

Estructura del proyecto

mcp-reservation-server/
├── src/
│   ├── index.ts          # 主服务器文件
│   ├── wechat-api.ts     # 微信API客户端
│   └── types.ts          # 类型定义
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

Comandos de compilación

npm run build - Compilar TypeScript
npm run dev - Ejecutar en modo desarrollo
npm run clean - Limpiar archivos de compilación

Licencia

MIT License

Contribuciones

¡Bienvenidos a enviar Issues y Pull Requests!