Instafan

io.github.gustavoatar由 GitHub 账号 gustavoatar 发布v1.1.0更新于 Oct 24, 2026

Plan trips with friends: mood search, live briefs, top spots with photos, day-by-day itineraries.

已验证Streamable HTTP可网页运行位置与生活网页搜索与抓取

概览

AI 生成的概览

Instafan 是一个托管式旅行规划 MCP 服务器，让助手按心情推荐目的地、提供目的地简报、列出真实评分景点及照片，并生成逐日行程。

可以做什么
根据旅行心情或约束条件推荐 3 至 5 个目的地，并说明推荐理由；对单个目的地给出简短简报，涵盖当地风貌、本月典型天气和官方安全评级，并附明信片照片链接。列出目的地中最值得去的真实 Google 评分地点，默认是热门景点，也可指定如精品咖啡或屋顶酒吧等具体需求。以内嵌方式展示某个地点的最多两张真实照片（注明 Google 地图作者），或展示目的地明信片。基于目的地最强的真实地点生成逐日行程，并附上在 Instafan 上组织结伴旅行的链接。
适用场景
适合旅行者尚未确定目的地、希望按心情或条件获得建议时，也适合在决定前快速了解某地的天气与安全情况。也适用于需要真实评分地点和逐日计划、并希望之后转为多人共同决策的行程。
运行要求
远程 streamable-HTTP 端点，无需安装，也无需身份验证。客户端需支持远程 MCP 服务器，并填入 Instafan 的端点地址。需要能访问该服务的网络。
安装前请注意
回答会链接回 instafan.app，行程在那里继续作为群体决策，因此该服务兼具推广性质。目的地、天气和安全数据来自第三方来源（Google Places、气候常年值、官方通告），预订前应自行核实。照片版权归其 Google 地图作者所有。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Instafan，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.gustavoatar%2Finstafan/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "instafan": {
      "type": "http",
      "url": "https://instafan.app/mcp"
    }
  }
}

README

Instafan MCP Server

Let AI agents plan real trips — where to go for a mood, what a destination is like right now, its strongest Google-rated places with photos, and a day-by-day plan — using Instafan's live data (Google Places, climate normals, official safety advisories).

Hosted, no install, no auth. Streamable-HTTP endpoint:

https://instafan.app/mcp

Tools

ToolWhat it doesInputs
find_destinationsA trip mood or constraint set ("somewhere warm in November, food-first") → 3–5 destination suggestions with the why.mood (required)
destination_briefOne destination: the story, typical weather this month, official safety verdict, a postcard photo link.destination (required)
top_spotsThe strongest real Google-rated places — top attractions by default, or a specific ask like "rooftop bars" — with photo links. Never invented.destination (required), query
build_itineraryA day-by-day plan built from the destination's strongest places.destination, days (both required)
spot_photosUp to two real photos of one spot, embedded inline as MCP image blocks plus direct links, credited to their Google Maps authors.destination (required), spot

Connect

ChatGPT → Settings → Apps & Connectors → enable Developer mode → Create → URL: https://instafan.app/mcp, auth: none.

Claude Desktop / Claude.ai → Settings → Connectors → Add custom connector → URL: https://instafan.app/mcp

Claude Code:

bash
claude mcp add instafan --transport http https://instafan.app/mcp

Cursor / other MCP clients — add a remote (streamable-http) server pointing at the URL above. One-click: see https://instafan.app/connect/

Test with curl:

bash
curl -s -X POST https://instafan.app/mcp \  -H "Content-Type: application/json" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example

"Build me a Lisbon trip for my wife and I in the best weather."

The agent calls destination_brief → learns Lisbon is 18–26°C with ~4 rainy days right now and officially rated relaxed; top_spots → real rated places with photos; spot_photos → Belém Tower, inline; build_itinerary → a day-by-day plan. Every answer links back into instafan.app, where the trip becomes a group decision — immerse in 3D, save spots, let the group vote.

About

Built by Instafan — plan trips with friends. https://instafan.app

License

MIT

来源：README.md，提交 14ab1cd

工具

5

find_destinations

Suggest 3-5 destinations for a trip mood or constraint set, e.g. "somewhere warm in November, food-first". Use when the traveller has not settled on a place yet.

输入参数mood必填

destination_brief

A short brief on one destination: what it is like, typical weather now, official safety verdict. Use before or instead of a full itinerary.

输入参数destination必填

top_spots

The strongest real places in a destination — top attractions by default, or a specific ask like "specialty coffee" or "rooftop bars". Real Google-rated places, never invented.

输入参数querydestination必填

build_itinerary

Build a day-by-day itinerary for a destination from its strongest real places. Returns the plan plus links to run it as a group trip on Instafan.

输入参数days必填destination必填

spot_photos

Real photos of one spot — up to two shown inline plus direct photo links. Name a specific place ("Belém Tower") or leave spot empty for a postcard of the destination itself.

输入参数spotdestination必填

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。