内容
# travel.art 对话服务器
艺术旅游数据（双年展、艺术博览会、博物馆参观指南）为人工智能代理提供的模型上下文协议服务器。
实时访问 **https://mcp.travel.art/**。公共、无身份验证、免费。
## 功能
四个工具，通过MCP Streamable HTTP（请求/响应模式，JSON-RPC 2.0 via HTTP POST）访问：
### `查找艺术活动`
搜索 travel.art 的双年展、艺术博览会和节日目录。
```json
{
"名称": "查找艺术活动",
"参数": {
"查询": "双年展", // 可选的自由文本
"国家": "IT", // 可选的ISO 3166-1 alpha-2
"类型": "艺术博览会", // 可选：双年展 | 艺术博览会 | 节日
"活动日期": "2026-06-20", // 可选的ISO 8601日期
"开始后": "2026-09-01",
"结束前": "2026-12-31"
}
}
```
返回具有日期、场地、门票信息、摘要和指向 travel.art 完整编辑参观指南的规范 `指南网址` 的活动。
### `查找博物馆指南`
搜索 travel.art 的博物馆参观指南目录。
```json
{
"名称": "查找博物馆指南",
"参数": {
"查询": "卢浮宫",
"城市": "巴黎",
"国家": "法国"
}
}
```
返回具有当前2026年门票信息（包括卢浮宫的两种价格：€22欧盟 / €32非欧盟，*卢浮宫新文艺复兴*），开放时间，基本展品，按参观顺序，路线持续时间和`指南网址`的博物馆。
### `查找中转行程`
搜索 travel.art 的3-6小时艺术焦点中转计划，从主要欧洲枢纽机场出发。
```json
{
"名称": "查找中转行程",
"参数": {
"查询": "卡拉瓦乔", // 可选的自由文本
"城市": "罗马", // 可选
"国家": "意大利", // 可选
"机场": "FCO", // 可选的IATA代码（例如：MXP，CDG，AMS）
"最大持续时间小时": 4 // 可选的上限
}
}
```
返回具有服务机场、地面时间预算、艺术焦点（艺术家/博物馆/主题）、关键场馆、2026年验证亮点（预订规则、周一闭馆陷阱、换乘数学）和`指南网址`到完整逐小时指南的行程。
### `推荐艺术之旅`
为一座城市推荐艺术旅游行程。仅基于 travel.art 已发布的內容 —— 没有编造。
```json
{
"名称": "推荐艺术之旅",
"参数": {
"城市": "佛罗伦萨",
"开始日期": "2026-06-15",
"结束日期": "2026-06-18"
}
}
```
返回在行程日期期间活跃的活动和城市的博物馆指南，每个指南都有`指南网址`。
## 快速测试
```bash
# 健康检查
curl https://mcp.travel.art/health
# 列表工具（MCP）
curl -X POST https://mcp.travel.art/ \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# 调用工具
curl -X POST https://mcp.travel.art/ \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"find_art_events","arguments":{"country":"IT"}}}'
```
## 配置您的MCP客户端
### 克劳德桌面
添加到 `~/Library/Application Support/Claude/claude_desktop_config.json` （macOS）或Windows/Linux等效文件：
```json
{
"mcpServers": {
"travel-art": {
"url": "https://mcp.travel.art/"
}
}
}
```
重启克劳德桌面。这三个工具应该出现在可用工具列表中。
### 光标、继续、mcp-inspector、您自己的代理
任何支持Streamable HTTP传输的MCP客户端都以相同的方式工作 —— 将其指向 `https://mcp.travel.art/`。
### 在stdio上本地运行
相同的目录和相同的三个工具也作为本地 **stdio** MCP服务器提供，对于更喜欢使用spawned进程而不是远程URL的客户端（并且目录评估者可以在不访问托管端点的情况下检查服务器）：
```bash
git clone https://github.com/alexzavialov/travel-art-mcp.git
cd travel-art-mcp
npm install
npm start # → npx tsx src/stdio.ts
```
将其连接到克劳德桌面作为本地服务器而不是远程网址：
```json
{
"mcpServers": {
"travel-art": {
"command": "npx",
"args": ["tsx", "src/stdio.ts"]
}
}
}
```
stdio服务器在功能上与托管端点相同 —— 相同的 `tools.ts`，相同的 `data.ts`。
## 目录
截至最新发布：
- **艺术活动（22）：** 6个基石活动（惠特尼双年展、威尼斯双年展、艺术巴塞尔瑞士/巴黎/迈阿密、弗里兹伦敦）+ 16个目录活动，涵盖4个大陆 —— 悉尼/横滨/光州/里昂/Manifesta-16鲁尔双年展；艺术巴塞尔香港、弗里兹纽约/首尔、芝加哥EXPO、纽约TEFAF、军械库展、1-54伦敦、艺术SG艺术博览会；罗斯科/佛罗伦萨、拉斐尔/大都会、杜尚/现代艺术博物馆展览
- **博物馆精华（12）：** 卢浮宫、奥赛博物馆、梵蒂冈博物馆 + 西斯廷教堂、乌菲兹美术馆、普拉多博物馆、大都会博物馆、现代艺术博物馆、索菲亚王后博物馆、国家博物馆、梵高博物馆、泰特现代艺术馆
- **中转行程（6）：** 米兰（达芬奇，5小时MXP/LIN）、罗马（卡拉瓦乔，4小时FCO/CIA）、佛罗伦萨（文艺复兴，6小时FLR/PSA）、阿姆斯特丹（国家博物馆 + 梵高博物馆，4小时AMS）、巴黎（卢浮宫闪电，3小时CDG/ORY）、伦敦（大都会 + 泰特，5小时LHR/LGW/STN/LTN/LCY）
- **每周增长** 随着travel.art上新的基石文章发布
每个记录都包含一个`lastVerified` ISO日期；权重新鲜度的AI代理可以优先选择最近验证的记录。
## 源代码
```
src/
index.ts # 工作线程入口 — MCP HTTP协议（JSON-RPC 2.0），GET信息页面，/health，/robots.txt
stdio.ts # 本地stdio入口 — 相同工具通过MCP stdio传输（@modelcontextprotocol/sdk）
tools.ts # 工具定义 + 处理程序（由两个入口共享）
data.ts # 静态数据集（类型事件 + 博物馆）
package.json
tsconfig.json
wrangler.toml # Cloudflare Workers配置
```
技术栈：TypeScript。两个传输共享一个代码库：**托管**入口（`index.ts`）直接实现MCP HTTP（JSON-RPC 2.0），以兼容Cloudflare Workers；**本地**入口（`stdio.ts`）使用`@modelcontextprotocol/sdk`通过stdio传输。两者都从`tools.ts` + `data.ts`提供相同的工具。
## 部署您自己的副本
```bash
git clone https://github.com/alexzavialov/travel-art-mcp.git
cd travel-art-mcp
npm install
npx wrangler login # 如果没有
npx wrangler deploy
```
您需要一个Cloudflare账户（免费层足够 — 每天100k请求）。
要绑定到自定义域名，请在`wrangler.toml`中更新`routes`条目，或者使用Cloudflare仪表板的*Workers → 您的Worker → 设置 → 触发器*添加自定义域名。
## 贡献
问题和拉取请求欢迎。
目录（`src/data.ts`）是从 travel.art 上发布的基石文章手动策划的。添加新活动、博物馆或目的地的补丁应该理想地附带一个相应的 travel.art 游客指南，以便 `guideUrl` 链接解析为实质性内容 —— 但对于具有引用的高质量事实数据（有来源引用）的例外情况。
## 许可证
[MIT](LICENSE)。使用它，fork 它，使用您自己的目录部署您自己的副本。
## 联系
- 服务器端问题/数据更正：<a href="mailto:mcp@travel.art">mcp@travel.art</a>
- 一般 travel.art 编辑：<a href="mailto:editor@travel.art">editor@travel.art</a>
- 项目首页：[travel.art](https://travel.art/)
- 隐私政策：[travel.art/privacy/](https://travel.art/privacy/)
