Content
# Tool List
[](https://www.npmjs.com/package/hiito-mcp-server)
[](https://github.com/Qiuzer/Hiito-MCP)
[](LICENSE)
Let AI assistants help you discover nearby car tail party events.
> **MCP (Model Context Protocol)** server, providing query capabilities for car tail parties to AI clients like Claude Desktop, Cursor, Cline, etc.
---
## 🎯 One-minute usage
### Recommended: Tencent Cloud MCP Plaza one-click deployment
1. Visit [Tencent Cloud MCP Plaza](https://cloud.tencent.com/developer/mcp)
2. Search for **"Hiito"**
3. One-click deployment, no configuration required
After deployment, you can use it in any AI client that supports MCP.
> **Why recommend MCP Plaza?** This project relies on Tencent Cloud CloudBase's proprietary environment and credentials. Local operation requires access permissions to the corresponding environment. MCP Plaza has deployed a complete cloud hosting service, and users do not need to worry about underlying configurations.
### Local development
If you have your own Tencent Cloud CloudBase environment, you can develop your own MCP Server based on this source code:
```bash
git clone https://github.com/Qiuzer/Hiito-MCP.git
cd Hiito-MCP
npm install
# Configure your environment variables
cp .env.example .env
# Edit .env and fill in your Tencent Cloud environment ID and credentials
npm run build
npm start
```
> **Note**: Using your own credentials can only access your own environment's data, not Hiito's party data. This is due to Tencent Cloud IAM's authentication mechanism.
---
## ✨ Features
### 🔍 `party_search_nearby` — Search for nearby parties
Search for nearby party events based on latitude and longitude, and return party name, location, distance, and other information.
**Parameters:**
| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `latitude` | number | ✅ | Latitude, -90 ~ 90 |
| `longitude` | number | ✅ | Longitude, -180 ~ 180 |
| `radius` | number | ❌ | Search radius (meters), default 5000, maximum 50000 |
| `limit` | number | ❌ | Return count, default 20, maximum 50 |
| `offset` | number | ❌ | Pagination offset, default 0 |
**Example conversation:**
```
User: "What parties are nearby?"
AI: Call party_search_nearby (requires user authorization for location)
User: "What car tail parties are near Shanghai's Bund?"
AI: Call party_search_nearby (latitude=31.2304, longitude=121.4737)
```
**Return format:**
```markdown
## 🎉 Nearby party events
### Weekend Retro Market Party
- 📍 **Location**: Shanghai, Huangpu District, Bund XX
- 📏 **Distance**: 1200m
- 🕐 **Time**: 2026/05/15 14:00
---
```
---
## 🔌 Integration with AI clients
### Method 1: Direct configuration (recommended)
For AI clients that support HTTP + SSE transmission mode, directly copy the following configuration to use, **no authentication required**:
```json
{
"mcpServers": {
"hiito": {
"type": "http",
"url": "https://hiito-mcp-server-254685-6-1375170188.sh.run.tcloudbase.com/mcp"
}
}
}
```
**Supported clients:**
- Claude Desktop (new version supports HTTP mode)
- Cursor
- Cline
- Other clients that support MCP HTTP transmission
### Method 2: Tencent Cloud MCP Plaza
Visit [Tencent Cloud MCP Plaza](https://cloud.tencent.com/developer/mcp) and search for **"Hiito"** to deploy with one click.
### Local development mode
For local debugging, use stdio mode:
```json
{
"mcpServers": {
"hiito": {
"command": "node",
"args": ["/path/to/Hiito-MCP/dist/index.js"]
}
}
}
```
---
## 🔒 Security instructions
### Why open-source?
The core purpose of open-sourcing this project is **transparent and auditable**:
- Users can verify that MCP Server only performs **read-only queries**, without writing, modifying, or deleting any data
- Users can confirm that no personal privacy information is collected or uploaded
- The community can help discover and fix security issues
### Data security guarantees
| Security layer | Mechanism |
| --- | --- |
| **Transport layer** | HTTPS encryption transmission |
| **Application layer** | Cloud function whitelist (only allows `post` calls) |
| **Data layer** | Read-only operation, `readOnlyHint: true` |
| **Protection layer** | Rate limiting (15 minutes / 100 times / IP) |
### Service security
This service is deployed in Tencent Cloud CloudBase's cloud hosting environment:
- **Read-only service**: Only provides party query functionality, without writing, modifying, or deleting any data
- **Data isolation**: Ensures data isolation between different environments through Tencent Cloud IAM
- **Environment variables**: Credentials are managed through CloudBase environment variables, with no sensitive information in the source code
---
## 🏗️ Technical architecture
```
┌───────────────────────────────────┐
│ AI clients │
│ (Claude / Cursor / Cline / ...) │
└──────────────┬────────────────────┘
│ MCP Protocol (JSON-RPC 2.0)
▼
┌───────────────────────────────────┐
│ MCP Server（cloud hosting） │
│ │
│ ┌─────────────────────────────┐ │
│ │ Transport │ │
│ │ ├── Stdio（local mode） │ │
│ │ └── Streamable HTTP（remote） │ │
│ │ │ │
│ │ Tools │ │
│ │ └── party_search_nearby │ │
│ └─────────────────────────────┘ │
└──────────────┬────────────────────┘
│ Cloud invocation (callFunction)
│ Tencent Cloud IAM authentication
▼
┌───────────────────────────────────┐
│ Hiito production environment │
│ │
│ ┌─────────────────────────────┐ │
│ │ Cloud function（query routing） │ │
│ │ └── Geo-location query（geoNear） │ │
│ └─────────────────────────────┘ │
│ │
│ ┌─────────────────────────────┐ │
│ │ Database │ │
│ │ ├── party_sessions │ │
│ │ └── organizer_bios │ │
│ └─────────────────────────────┘ │
└───────────────────────────────────┘
```
### Technical stack
| Component | Technology |
| --- | --- |
| Protocol standard | Model Context Protocol (MCP) 1.0 |
| Transmission mode | HTTP + SSE / stdio |
| Runtime environment | Node.js 18+ / CloudBase cloud hosting |
| MCP SDK | `@modelcontextprotocol/sdk` |
| Cloud development SDK | `@cloudbase/node-sdk` |
| Build tool | TypeScript |
---
## 📁 Project structure
```
MCP-Server/
├── src/ # Source code
│ ├── index.ts # MCP Server entry
│ ├── types.ts # TypeScript type definitions
│ ├── tools/
│ │ ├── party_tools.ts # Party search tools
│ │ └── formatters.ts # Response formatting
│ ├── schemas/
│ │ └── index.ts # Zod parameter validation schema
│ ├── services/
│ │ └── cloudbase.ts # CloudBase cloud function calls
│ └── utils/
│ └── errors.ts # Error handling
├── package.json
├── tsconfig.json
└── vitest.config.ts
```
---
## 🧪 Testing
```bash
# Unit testing
npm test
# Interactive debugging with MCP Inspector
npx @modelcontextprotocol/inspector
```
---
## 📄 License
[MIT License](LICENSE) — You can freely use this source code as a template to develop your own MCP Server, but you cannot access Hiito's data through this source code.
---
## 🔗 Related links
- **WeChat mini-program**: Search for "Hiito"
- **MCP protocol documentation**: https://modelcontextprotocol.io/
- **CloudBase documentation**: https://docs.cloudbase.net/
- **Issue feedback**: https://github.com/Qiuzer/Hiito-MCP/issues
---
## ⭐ Star History
If this project helps you, give it a Star ⭐️!
[](https://star-history.com/#Qiuzer/Hiito-MCP&Date)
---
**Made with ❤️ by [Churze](https://github.com/Qiuzer)**
