travel.art

mcp/

travel.art 的模型上下文协议服务。访问地址：**https://mcp.travel.art/**。

功能

通过模型上下文协议（Streamable HTTP 传输，request/response 模式）向 AI Agent 提供 travel.art 的艺术旅游数据。

v1 版本包含三个工具：

• find_art_events — 双年展、艺术博览会、艺术节，包含日期、场地、票务信息、简介以及完整指南链接
• find_museum_guide — 主要博物馆（卢浮宫、梵蒂冈博物馆、乌菲兹美术馆），包含 2026 年票务信息、开放时间和必看作品
• recommend_art_trip — 仅使用已发布的 travel.art 内容，按城市提供行程建议

目录 v1.6.0：23 场活动 + 12 家博物馆 + 6 条中途停留行程（与已发布的日历和核心文章同步；活动信息于 2026-09-14 重新核实）。

技术栈

mcp/
  src/
    index.ts        # Worker entry, MCP HTTP protocol (JSON-RPC 2.0)
    tools.ts        # Tool definitions + handlers
    data.ts         # Static dataset (typed)
  scripts/          # (Future) sync from content/<slug>/index.md frontmatter
  data/             # (Future) sync output
  package.json
  wrangler.toml
  tsconfig.json

• 运行时： Cloudflare Workers，免费套餐（每天 100k 次请求）
• 语言： TypeScript
• 传输： MCP Streamable HTTP（request/response，不使用 SSE — 单次工具调用）
• 协议版本： 2025-03-26
• 身份验证： 无（公开只读）

使用方法

健康检查

curl https://mcp.travel.art/health

初始化握手

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-client","version":"0.1"}}}'

列出工具

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

调用工具

curl -X POST https://mcp.travel.art/ \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"find_art_events","arguments":{"country":"IT"}}}'

Claude Desktop 配置

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "travel-art": {
      "url": "https://mcp.travel.art/"
    }
  }
}

部署

cd mcp
npm install
npx wrangler deploy

（需要在环境变量中设置 CLOUDFLARE_API_TOKEN + CLOUDFLARE_ACCOUNT_ID，或使用 wrangler login。）

Worker 通过 Cloudflare API 绑定到自定义域名 mcp.travel.art（一次性设置；参见 DECISIONS.md 2026-05-08）。

后续计划（v2 待办事项）

• 构建时提取数据 — 用同步脚本替换手工整理的 data.ts，读取 content/<slug>/index.md frontmatter（从 Event 类型的 schema 中读取活动，从 Place 类型的 schema 中读取博物馆）。新的核心内容将自动进入 MCP。
• 更多工具 — find_artist_residencies、find_collateral_events、today_in_art_tourism（列出目录中今天开放的项目）。
• 身份验证层级 — 目前为公开只读。如果商业客户需要高频程序化访问，可在 Account API Tokens 下添加 API 密钥层级。
• 流式响应 — 对较长的行程建议，切换为 SSE。
• 速率限制 — 按 IP 限流（目前依赖 Cloudflare 自带的 DDoS 防护）。
• Schema 版本控制 — 在发生不兼容变更时，使用 mcp.travel.art/v1、/v2 URL 版本控制。

完整的 Agent 操作规范请参见 .claude/agents/mcp-architect.md。