Hiito MCP Server

npm version GitHub stars License: MIT

WeChatミニプログラム「螺母车尾派对」向けの Model Context Protocol (MCP) サービスです。

🌐 AIターミナル（Claude Desktop、Cursorなど）から、近くのパーティーの検索、パーティー詳細の取得、ミニプログラム共有リンクの生成が可能になります。

✨ 機能特性

🔍 パーティー検索

party_search_nearby - 緯度・経度と検索半径に基づいて、近くのパーティーイベントを検索します
party_list_upcoming - 近日開催予定のパーティーリストを取得します（時間順に昇順）
party_list_by_organizer - 指定した主催者が開催するすべてのパーティーを検索します

📋 パーティー詳細

party_get_detail - パーティーの完全な情報（時間、場所、主催者、参加人数など）を取得します

🔗 ディープリンク生成

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 クラウドホスティングへのデプロイ

CloudBase コンソールにアクセスします
環境を選択します
クラウドホスティング → サービスリスト に移動します
新規サービス をクリックします
Gitリポジトリからデプロイ を選択します
GitHubリポジトリ Qiuzer/Hiito-MCP を接続します
環境変数を設定します（.env.example を参照）
今すぐデプロイ をクリックします

詳細な手順は 👉 CLOUDBASE _DEPLOYMENT.md を確認してください

🔧 設定説明

環境変数

変数名	必須	説明
`WECHAT_APP_ID`	✅	WeChatミニプログラム AppID
`CLOUD_ENV_ID`	✅	CloudBase ソース環境 ID
`TARGET_ENV_ID`	✅	CloudBase ターゲット環境 ID
`MCP_AUTH_TOKEN`	🔒	MCP認証トークン（HTTPモードで推奨）
`TRANSPORT_MODE`	❌	転送モード：`stdio` または `http`（デフォルト `stdio`）
`PORT`	❌	HTTPモードのリスニングポート（デフォルト `8080`）
`CHARACTER_LIMIT`	❌	レスポンス文字数制限（デフォルト `25000`）

完全な設定説明は .env.example ファイルを確認してください。

🎯 アプリケーションシナリオ

1. AIアシスタントによる近くのパーティー検索

用户: "附近有什么派对？"
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ツールが使用可能になります。

🏗️ 技術アーキテクチャ

コンポーネント	技術スタック
プロトコル標準	Model Context Protocol (MCP) 1.0
転送モード	stdio / HTTP (デュアルモード)
実行環境	Node.js 18+ / CloudRun (コンテナ化)
データストレージ	CloudBase (Tencent Cloud Development)
ミニプログラムプラットフォーム	WeChatミニプログラム
ビルドツール	TypeScript + Docker

📁 プロジェクト構造

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 に接続します

🤝 貢献ガイド

コードの貢献、提案、問題の報告を歓迎します！

このリポジトリをForkする
特徴ブランチを作成する (git checkout -b feature/AmazingFeature)
変更をコミットする (git commit -m 'Add some AmazingFeature')
ブランチにプッシュする (git push origin feature/AmazingFeature)
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

⭐ Star History

このプロジェクトが役に立ったら、Star ⭐️ をお願いします！

Made with ❤️ by Churze

Hiito MCP Server

Hiito MCP Server

✨ 機能特性

🔍 パーティー検索

📋 パーティー詳細

🔗 ディープリンク生成

👤 主催者情報

🚀 クイックスタート

方法1：ローカル開発（stdioモード）

方法2：HTTPサーバーモード

📦 デプロイガイド

CloudBase クラウドホスティングへのデプロイ

🔧 設定説明

環境変数

🎯 アプリケーションシナリオ

1. AIアシスタントによる近くのパーティー検索

2. パーティー共有リンクの自動生成

3. 近日開催パーティーのインテリジェントレコメンデーション

4. 主催者の信頼性評価

🔌 Claude Desktopへの統合

🏗️ 技術アーキテクチャ

📁 プロジェクト構造

🧪 テスト

ローカルでのHTTPモードテスト

MCPエンドポイントのテスト

🤝 貢献ガイド

📝 更新履歴

v1.0.0 (2026-05-07)

📄 ライセンス

🔗 関連リンク

⭐ Star History

Resources

Related MCP Connectors