MCP Ai Agent Campusdatemap
作者 @wsyqwsyq
MCP server by wsyqwsyq
创建于 12/21/2025
更新于 about 21 hours ago
README
Repository documentation and setup instructions
🗺️ Campus Date Map (校园约会地图)
📖 项目介绍
这是一个专为大学生打造的校园周边约会地图应用。结合了高德地图 API 和 AI 大模型智能搜索功能,帮助用户轻松发现学校周边的优质餐厅、娱乐场所和浪漫打卡点。
✨ 核心功能
- 📍 精准定位:基于高德地图的高精度定位,自动锁定当前位置,支持手动切换位置。
- 🔍 智能筛选:支持按距离(500m/1.5km/3km)、人均价格、餐厅类型进行多维度筛选。
- 🤖 AI 智能助手:集成阿里云百炼大模型,支持自然语言搜索(例如:“适合情侣的安静咖啡馆”),智能分析意图并推荐地点。
- 💬 互动打卡:支持用户注册登录,查看地点详情,收藏地点,发表评论与打卡。
- 🗺️ 路线规划:一键导航至目的地,并智能推荐饭后好去处(电影院、公园、花店等)。
🛠️ 技术栈
- 前端:HTML5, CSS3, JavaScript (原生), 高德地图 JS API
- 后端:Python (Flask)
- 数据库:SQLite
- AI 服务:阿里云 DashScope (通义千问)
🚀 快速开始
1. 环境准备
确保你的电脑已安装 Python 3.8 或以上版本。
2. 安装依赖
在项目根目录下运行以下命令安装所需 Python 库:
pip install -r requirements.txt
3. 配置环境变量
在项目根目录创建一个 .env 文件(或修改现有文件),填入你的 API 密钥:
# 高德地图 Web 服务 API Key (用于后端搜索)
AMAP_WEB_API_KEY=你的高德Web服务Key
# 高德地图 JS API 安全密钥 (用于前端地图加载)
AMAP_JS_SECURITY_CODE=你的高德JS安全密钥
# 阿里云 DashScope API Key (用于 AI 搜索功能)
DASHSCOPE_API_KEY=你的DashScopeKey
4. 启动项目
运行以下命令启动 Flask 后端服务:
python app.py
启动成功后,控制台将显示类似信息:
* Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)
5. 访问应用
打开浏览器,访问: http://localhost:5000
📂 项目结构
.
├── app.py # Flask 后端入口 (API & 页面服务)
├── index.html # 前端主页
├── js/
│ └── app.js # 前端核心逻辑 (地图交互、API调用)
├── css/
│ ├── style.css # 通用样式
│ └── comments.css # 评论区样式
├── campus_date.db # SQLite 数据库文件 (用户信息、评论、收藏)
├── requirements.txt # Python 依赖列表
└── .env # 环境变量配置文件
📝 注意事项
- 高德 Key 配置:请确保 Web 服务 Key 和 JS API Key 配对使用,并且 JS API Key 已在控制台绑定了相应的 Web 服务安全密钥。
- 数据库:
campus_date.db存储了用户数据,请妥善备份。 - 网络:AI 功能和地图加载需要正常的网络连接。
Enjoy your campus date! ❤️
快速设置
此服务器的安装指南
安装包 (如果需要)
npx @modelcontextprotocol/server--mcp-ai-agent-campusdatemap---
Cursor 配置 (mcp.json)
{
"mcpServers": {
"wsyqwsyq-mcp-ai-agent-campusdatemap": {
"command": "npx",
"args": [
"wsyqwsyq-mcp-ai-agent-campusdatemap"
]
}
}
}