城市推荐 MCP 服务

name: city-recommend
language: nodejs
start: node src/city_recommend.js
port: 3004

一个基于 MCP (Model Context Protocol) 的城市推荐服务，支持多种部署方式。

📁 项目结构

city-recommend-mcp/
├── 📁 docs/                    # 文档目录
│   ├── README.md              # 项目详细说明
│   ├── DEPLOYMENT.md          # 部署指南
│   ├── QUICK_DEPLOY.md        # 快速部署指南
│   ├── HF_BROWSER_DEPLOY.md   # Hugging Face 部署指南
│   └── SECURITY.md            # 安全指南
├── 📁 scripts/                 # 脚本目录
│   ├── deploy.sh              # 主部署脚本
│   ├── hf_deploy.sh           # Hugging Face 部署脚本
│   ├── push.sh                # Git 推送脚本
│   ├── setup-git.sh           # Git 设置脚本
│   └── setup-secure-credentials.sh # 安全凭证设置脚本
├── 📁 config/                  # 配置目录
│   └── env.example            # 环境变量示例
├── 📁 src/                     # 源代码目录
│   ├── app.py                 # 主应用文件
│   ├── city_recommend.js      # Node.js 服务文件
│   ├── hf_app_readme.md       # Hugging Face 应用说明
│   └── hf_requirements.txt    # Hugging Face 依赖文件
├── 📁 data/                    # 数据目录
│   └── city_spots.json        # 城市景点数据
├── 📁 ownvue-city-recommend/   # Vue.js 前端项目
├── 📁 node_modules/            # Node.js 依赖
├── package.json               # Node.js 项目配置
├── package-lock.json          # Node.js 依赖锁定文件
├── requirements.txt           # Python 依赖文件
└── .gitignore                # Git 忽略文件

🚀 快速开始

1. 安装依赖

# 安装 Node.js 依赖
npm install

# 安装 Python 依赖
pip install -r requirements.txt

2. 配置环境变量

# 复制环境变量模板
cp config/env.example .env

# 编辑 .env 文件，填入你的 API 密钥

3. 运行服务

# 启动 Node.js 服务
npm start

# 或者启动 Python 服务
python src/app.py

📚 文档

• 详细说明 - 项目功能和使用方法
• 部署指南 - 完整的部署说明
• 快速部署 - 快速部署步骤
• Hugging Face 部署 - HF Spaces 部署
• 安全指南 - 安全配置和最佳实践

🛠️ 脚本

• 主部署脚本 - 支持多种平台部署
• HF 部署脚本 - Hugging Face 专用部署
• 安全设置脚本 - 安全凭证配置

🔧 配置

• 环境变量示例 - 环境变量配置模板

📦 部署平台

• Hugging Face Spaces (推荐) - 完全免费，无限制
• Render - 免费套餐可用
• Fly.io - 3个小型VM免费
• Railway - 付费平台
• Vercel - 适合前端部署

🔒 安全

请务必阅读 安全指南 并按照建议配置安全的凭证管理。

�� 许可证

MIT License