Hiito MCP Server

Ein Model Context Protocol (MCP) Dienst für das WeChat-Mini-Programm „螺母车尾派对“.

🌐 Ermöglicht KI-Terminals (Claude Desktop, Cursor usw.), Partys in der Nähe zu suchen, Party-Details abzurufen und Mini-Programm-Freigabelinks zu generieren.

✨ Funktionen

🔍 Party-Suche

• party_search_nearby - Findet Party-Events in der Nähe basierend auf Längen- und Breitengrad sowie Suchradius

• party_list_upcoming - Ruft eine Liste der bald beginnenden Partys ab (aufsteigend sortiert nach Zeit)

• party_list_by_organizer - Fragt alle von einem bestimmten Veranstalter organisierten Partys ab

📋 Party-Details

• party_get_detail - Ruft vollständige Informationen zu einer Party ab (Zeit, Ort, Veranstalter, Teilnehmerzahl usw.)

🔗 Deep-Link-Generierung

• party_generate_deep_link - Generiert Kurzlinks (URL Scheme / URL Link) zum Öffnen des Mini-Programms, unterstützt das Öffnen innerhalb von WeChat und im Browser

👤 Veranstalter-Informationen

• organizer_get_info - Ruft das vollständige Profil des Veranstalters ab (Name, Kurzvorstellung, Zertifizierungsstatus, Statistiken)

🚀 Schnellstart

Methode 1: Lokale Entwicklung (stdio-Modus)

# 克隆仓库
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

Methode 2: HTTP-Server-Modus

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

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

📦 Bereitstellungsanleitung

Bereitstellung auf CloudBase Cloud Hosting

1. Besuchen Sie die CloudBase Konsole

2. Wählen Sie eine Umgebung aus

3. Gehen Sie zu Cloud Hosting → Dienstliste

4. Klicken Sie auf Neuen Dienst erstellen

5. Wählen Sie Aus Git-Repository bereitstellen

6. Verbinden Sie das GitHub-Repository Qiuzer/Hiito-MCP

7. Konfigurieren Sie die Umgebungsvariablen (siehe .env.example)

8. Klicken Sie auf Jetzt bereitstellen

Detaillierte Schritte finden Sie unter 👉 CLOUDBASE_DEPLOYMENT.md

🔧 Konfigurationshinweise

Umgebungsvariablen

Die vollständige Konfigurationsbeschreibung finden Sie in der Datei .env.example.

🎯 Anwendungsszenarien

1. KI-Assistent sucht Partys in der Nähe

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

2. Automatische Generierung von Party-Freigabelinks

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

3. Intelligente Empfehlung bald beginnender Partys

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

4. Bewertung der Glaubwürdigkeit von Veranstaltern

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

🔌 Integration in Claude Desktop

Bearbeiten Sie die Konfigurationsdatei von 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"
      }
    }
  }
}

Nach dem Neustart von Claude Desktop können Sie die Hiito-Tools verwenden.

🏗️ Technische Architektur

📁 Projektstruktur

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

🧪 Tests

Lokaler Test des HTTP-Modus

# 启动服务
TRANSPORT_MODE=http npm start

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

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

Testen der MCP-Endpunkte

Verwenden Sie den MCP Inspector:

npx @modelcontextprotocol/inspector

Verbinden Sie sich dann mit http://localhost:8080/mcp

🤝 Beitrag leisten

Beiträge zum Code, Vorschläge oder Fehlerberichte sind herzlich willkommen!

1. Forken Sie dieses Repository

2. Erstellen Sie einen Feature-Branch (git checkout -b feature/AmazingFeature)

3. Committen Sie Ihre Änderungen (git commit -m 'Add some AmazingFeature')

4. Pushen Sie den Branch (git push origin feature/AmazingFeature)

5. Öffnen Sie einen Pull Request

📝 Änderungsprotokoll

v1.0.0 (2026-05-07)

• ✅ Erstveröffentlichung

• ✅ Unterstützung für 6 MCP-Tools

• ✅ Unterstützung für stdio- und HTTP-Dual-Übertragungsmodus

• ✅ Unterstützung für Docker-Container-Bereitstellung

• ✅ Integration von CloudBase Cloud Development

📄 Lizenz

MIT License

🔗 Verwandte Links

• WeChat Mini-Programm: 螺母车尾派对 (suchen Sie nach "Hiito" oder "螺母车尾派对")

• MCP-Protokolldokumentation: https://modelcontextprotocol.io/

• CloudBase-Dokumentation: https://docs.cloudbase.net/

• Feedback: https://github.com/Qiuzer/Hiito-MCP/issues

⭐ Star History

Wenn Ihnen dieses Projekt hilft, geben Sie uns bitte einen Star ⭐️!

Made with ❤️ by Churze