使用说明
上海旅游景点导览项目
一个基于高德地图API和百度百科信息的上海主要旅游景点介绍网站,提供语音导览和交互式浏览体验。
📋 项目概述
本项目通过Cursor Agent调用MCP server生成HTML网页文件介绍上海的主要旅游景点。
- MCP server - 高德 高德地图API获取上海主要旅游景点信息,结合百度百科的详细介绍,生成一个包含5个代表性景点的交互式导览网站。
- MCP server - Minimax 通过MiniMax为根据文字生成音频导览。每个景点都配备语音导览功能,支持音频播放、暂停和切换。
- Agent - Cursor cursor agent 根据得到的信息以及prompt生成HTML网页
- Website deployment - youware 通过上传html file在youware上展示成果
📦 项目结构
shanghai-travel-guide/
├── README.md # 项目说明文档
├── shanghai-travel.html # 主页面文件
├── 上海主要旅游景点介绍.md # 景点介绍数据源
├── prompt.md # 设计规范文档
└── audio/ # 音频文件目录
├── 外滩语音介绍.mp3
├── 豫园语音介绍.mp3
├── 东方明珠语音介绍.mp3
├── 迪士尼语音介绍.mp3
└── 朱家角语音介绍.mp3
🚀 快速开始
配置API密钥
-
高德地图API配置
- 访问 高德开放平台
- 注册账号并创建应用
- 获取API Key
- 在
.cursor/mcp.json中配置:
{ "mcpServers": { "amap-amap-sse": { "url": "https://mcp.amap.com/sse?key=YOUR_API_KEY" } } } -
MiniMax API配置(当前不可用)
- 访问 MiniMax官网
- 注册并获取API密钥
- 在
.cursor/mcp.json中配置:
{ "mcpServers": { "MiniMax-MCP": { "type": "sse", "url": "https://mcp.api-inference.modelscope.net/YOUR_ENDPOINT", "env": { "MINIMAX_GROUP_ID": "YOUR_GROUP_ID" } } } }- 注意: 当前API余额不足,无法生成语音文件
生成语音文件
注意: 当前MiniMax MCP服务器由于API余额不足,无法直接生成语音文件。
-
MiniMax API状态
- MiniMax MCP服务器已配置但API余额不足
- 尝试生成语音时返回错误:
API Error: 1008-insufficient balance - 需要充值API账户才能使用语音生成功能
-
替代方案
- 手动录制音频文件
- 使用其他TTS服务(如Azure Speech、Google TTS等)
- 使用在线语音合成工具
- 确保音频文件格式为MP3
- 文件大小建议控制在2MB以内
- 将音频文件命名为:
外滩语音介绍.mp3、豫园语音介绍.mp3等
生成网页
- 根据prompt和得到的文字,音频信息生成html
- upload html file to youware.com and check
Reference
- 极客时间 MCP & A2A 前沿实战 - 黄佳