Hiito MCP Server

Сервис Model Context Protocol (MCP) для мини-программы WeChat «螺母车尾派对».

🌐 Позволяет ИИ-терминалам (Claude Desktop, Cursor и др.) искать ближайшие вечеринки, получать подробную информацию о них и генерировать ссылки для обмена мини-программами.

✨ Функциональные возможности

🔍 Поиск вечеринок

• party_search_nearby - поиск ближайших вечеринок по координатам и радиусу поиска

• party_list_upcoming - получение списка предстоящих вечеринок (в порядке возрастания времени)

• party_list_by_organizer - поиск всех вечеринок, организованных указанным организатором

📋 Подробная информация о вечеринке

• party_get_detail - получение полной информации о вечеринке (время, место, организатор, количество участников и т.д.)

🔗 Генерация глубоких ссылок (Deep Links)

• party_generate_deep_link - генерация коротких ссылок для открытия мини-программы (URL Scheme / URL Link), поддерживается открытие внутри WeChat и в браузере

👤 Информация об организаторе

• organizer_get_info - получение полного профиля организатора (название, описание, статус верификации, статистика)

🚀 Быстрый старт

Способ 1: Локальная разработка (режим 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

Способ 2: Режим HTTP-сервера

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

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

📦 Руководство по развертыванию

Развертывание в CloudBase (облачный хостинг)

1. Перейдите в консоль CloudBase

2. Выберите среду

3. Перейдите в Облачный хостинг → Список сервисов

4. Нажмите Создать сервис

5. Выберите Развертывание из Git-репозитория

6. Подключите GitHub-репозиторий Qiuzer/Hiito-MCP

7. Настройте переменные окружения (см. .env.example)

8. Нажмите Развернуть сейчас

Подробные шаги см. 👉 CLOUDBASE_DEPLOYMENT.md

🔧 Инструкция по настройке

Переменные окружения

Полное описание конфигурации см. в файле .env.example.

🎯 Сценарии использования

1. ИИ-ассистент для поиска ближайших вечеринок

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

2. Автоматическая генерация ссылок для обмена вечеринками

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

3. Интеллектуальная рекомендация предстоящих вечеринок

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

4. Оценка надежности организатора

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

🔌 Интеграция в Claude Desktop

Отредактируйте файл конфигурации 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"
      }
    }
  }
}

После перезапуска Claude Desktop инструменты Hiito станут доступны.

🏗️ Техническая архитектура

📁 Структура проекта

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                 # 项目文档

🧪 Тестирование

Локальное тестирование HTTP-режима

# 启动服务
TRANSPORT_MODE=http npm start

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

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

Тестирование MCP-эндпоинтов

Используйте MCP Inspector:

npx @modelcontextprotocol/inspector

Затем подключитесь к http://localhost:8080/mcp

🤝 Руководство по участию

Приветствуется вклад в код, предложения или сообщения об ошибках!

1. Сделайте Fork этого репозитория

2. Создайте ветку для функции (git checkout -b feature/AmazingFeature)

3. Зафиксируйте изменения (git commit -m 'Add some AmazingFeature')

4. Отправьте изменения в ветку (git push origin feature/AmazingFeature)

5. Откройте Pull Request

📝 Журнал изменений

v1.0.0 (2026-05-07)

• ✅ Выпуск начальной версии

• ✅ Поддержка 6 инструментов MCP

• ✅ Поддержка двойного режима передачи stdio и HTTP

• ✅ Поддержка развертывания в Docker-контейнерах

• ✅ Интеграция с облачной разработкой CloudBase

📄 Лицензия

MIT License

🔗 Полезные ссылки

• Мини-программа WeChat: 螺母车尾派对 (поиск по "Hiito" или "螺母车尾派对")

• Документация протокола MCP: https://modelcontextprotocol.io/

• Документация CloudBase: https://docs.cloudbase.net/

• Обратная связь: https://github.com/Qiuzer/Hiito-MCP/issues

⭐ История звезд

Если этот проект был вам полезен, пожалуйста, поставьте звезду ⭐️!

Сделано с ❤️ Churze