Servidor MCP Hiito

Servicio de Model Context Protocol (MCP) para el mini-programa de WeChat "螺母车尾派对".

🌐 Permite que los terminales de IA (Claude Desktop, Cursor, etc.) consulten fiestas cercanas, obtengan detalles de las fiestas y generen enlaces de compartición para el mini-programa.

✨ Características

🔍 Búsqueda de fiestas

• party_search_nearby - Busca eventos de fiesta cercanos según la latitud, longitud y radio de búsqueda

• party_list_upcoming - Obtiene una lista de las próximas fiestas (ordenadas cronológicamente)

• party_list_by_organizer - Consulta todas las fiestas organizadas por un organizador específico

📋 Detalles de la fiesta

• party_get_detail - Obtiene la información completa de la fiesta (hora, lugar, organizador, número de asistentes, etc.)

🔗 Generación de enlaces profundos

• party_generate_deep_link - Genera enlaces cortos (URL Scheme / URL Link) para abrir el mini-programa, compatibles con WeChat y navegadores

👤 Información del organizador

• organizer_get_info - Obtiene el perfil completo del organizador (nombre, biografía, estado de verificación, estadísticas)

🚀 Inicio rápido

Método 1: Desarrollo local (modo stdio)

# 克隆仓库
git clone git@github.com:Qiuzer/Hiito-MCP.git
cd Hiito-MCP

# 安装依赖
npm install

# 配置环境变量
cp .env.example .env
# 编辑 .env 文件，填入真实配置

# 编译 TypeScript
npm run build

# 启动服务（stdio 模式）
TRANSPORT_MODE=stdio npm start

Método 2: Modo servidor HTTP

# 配置环境变量后
TRANSPORT_MODE=http npm start

# 服务运行在 http://localhost:8080
# 健康检查: http://localhost:8080/health
# MCP 端点: http://localhost:8080/mcp

📦 Guía de despliegue

Despliegue en CloudBase Cloud Hosting

1. Acceda a la consola de CloudBase

2. Seleccione el entorno

3. Vaya a Cloud Hosting → Service List

4. Haga clic en New Service

5. Seleccione Deploy from Git repository

6. Conecte el repositorio de GitHub Qiuzer/Hiito-MCP

7. Configure las variables de entorno (consulte .env.example)

8. Haga clic en Deploy Now

Para pasos detallados, consulte 👉 CLOUDBASE_DEPLOYMENT.md

🔧 Configuración

Variables de entorno

Consulte el archivo .env.example para obtener una descripción completa de la configuración.

🎯 Casos de uso

1. Asistente de IA para consultar fiestas cercanas

用户: "附近有什么派对？"
AI: 调用 party_search_nearby 工具，返回附近派对列表

2. Generación automática de enlaces de compartición de fiestas

用户: "帮我生成一个派对分享链接"
AI: 调用 party_generate_deep_link 工具，返回小程序打开链接

3. Recomendación inteligente de próximas fiestas

用户: "这周有什么派对推荐吗？"
AI: 调用 party_list_upcoming 工具，返回近期派对列表

4. Evaluación de credibilidad del organizador

用户: "这个主办方靠谱吗？"
AI: 调用 organizer_get_info 工具，返回主办方详细资料

🔌 Integración con Claude Desktop

Edite el archivo de configuración de Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "hiito": {
      "command": "node",
      "args": ["/path/to/Hiito-MCP/dist/index.js"],
      "env": {
        "TRANSPORT_MODE": "stdio",
        "WECHAT_APP_ID": "your_app_id",
        "CLOUD_ENV_ID": "your_cloud_env_id",
        "TARGET_ENV_ID": "your_target_env_id"
      }
    }
  }
}

Reinicie Claude Desktop para empezar a usar las herramientas de Hiito.

🏗️ Arquitectura técnica

📁 Estructura del proyecto

Hiito-MCP/
├── src/                        # 源代码
│   ├── index.ts               # 主入口文件
│   ├── tools/                 # MCP 工具定义
│   │   ├── party_tools.ts            # 派对相关工具
│   │   └── link_and_organizer_tools.ts  # 链接和主办方工具
│   ├── services/              # 后端服务
│   │   └── cloudbase.ts             # CloudBase 数据库查询
│   └── utils/                # 工具函数
│       └── validators.ts             # 参数验证
├── dist/                       # 编译输出（git ignore）
├── Dockerfile                  # 容器化配置
├── .env.example               # 环境变量模板
├── package.json               # 项目配置
├── tsconfig.json              # TypeScript 配置
└── README.md                 # 项目文档

🧪 Pruebas

Pruebas locales en modo HTTP

# 启动服务
TRANSPORT_MODE=http npm start

# 健康检查
curl http://localhost:8080/health

# 预期返回：
# {
#   "status": "ok",
#   "service": "hiito-mcp-server",
#   "version": "1.0.0",
#   "config": {...}
# }

Probar endpoints MCP

Utilice MCP Inspector:

npx @modelcontextprotocol/inspector

Luego conéctese a http://localhost:8080/mcp

🤝 Guía de contribución

¡Las contribuciones, sugerencias y reportes de errores son bienvenidos!

1. Haga un Fork de este repositorio

2. Cree una rama de características (git checkout -b feature/AmazingFeature)

3. Confirme sus cambios (git commit -m 'Add some AmazingFeature')

4. Empuje a la rama (git push origin feature/AmazingFeature)

5. Abra un Pull Request

📝 Registro de cambios

v1.0.0 (2026-05-07)

• ✅ Lanzamiento de la versión inicial

• ✅ Soporte para 6 herramientas MCP

• ✅ Soporte para modo de transporte dual stdio y HTTP

• ✅ Soporte para despliegue en contenedores Docker

• ✅ Integración con CloudBase Cloud Development

📄 Licencia

Licencia MIT

🔗 Enlaces relacionados

• Mini-programa de WeChat: 螺母车尾派对 (busque "Hiito" o "螺母车尾派对")

• Documentación del protocolo MCP: https://modelcontextprotocol.io/

• Documentación de CloudBase: https://docs.cloudbase.net/

• Reporte de problemas: https://github.com/Qiuzer/Hiito-MCP/issues

⭐ Historial de estrellas

Si este proyecto le resulta útil, ¡por favor déjenos una estrella ⭐️!

Hecho con ❤️ por Churze