mcpField
R
rendezvous-mcp

rendezvous-mcp

本地服务
github.com/forgesworn地图与出行01 周前更新
代码仓库

关于 rendezvous-mcp

rendezvous-mcp 是用于发现公平会面地点的 MCP 服务，面向需要结合参与者实际出行时间与场所信息规划会面的 AI。它用等时圈和公平评分排序候选地点，而非仅取地理中点。

主要功能

  1. 01按出行时间公平性评分
  2. 02搜索附近场所
  3. 03生成等时圈
  4. 04提供逐步路线
  5. 05支持多名参与者

适用场景

  1. 01为多人午餐寻找公平会面点
  2. 02比较候选地点的个人出行时间
  3. 03查看指定时间内可到达区域
  4. 04获取会面地点的驾车路线

MCP 相关

向 MCP 客户端提供场所搜索、候选地点评分、等时圈和路线工具；支持 stdio 与 Streamable HTTP 传输。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "dev-forgesworn-rendezvous": {
      "command": "npx",
      "args": [
        "-y",
        "rendezvous-mcp"
      ],
      "env": {
        "VALHALLA_URL": "<VALHALLA_URL>"
      }
    }
  }
}
启动命令npx -y rendezvous-mcp
需要配置的环境变量
VALHALLA_URLValhalla routing engine URL

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmrendezvous-mcp1.1.3

工具

5

收录的工具列表 · 更新于 2 周前

参数类型必填说明
venuesarray是要评分的候选场所（1–50）
fairnessenum否评分策略：min_max（默认，尽量缩短最长行程）、min_total（尽量减少总出行时间）、min_variance（使出行时间趋于均等）min_max | min_total | min_variance
participantsarray是参与者位置（2–10 人）
transport_modeenum是参与者将采用的出行方式drive | cycle | walk

详细介绍

rendezvous-mcp

Nostr： npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

为 AI 寻找公平的会面地点——基于等时圈的公平性，而非简单的中点。

npm licence TypeScript Nostr GitHub Sponsors

用于 AI 驱动的会面地点发现的 MCP 服务。让 AI 能够根据实际出行时间、场所可用性和公平性算法回答**“我们该在哪里见面？”**

开箱即用——提供免费的公共路线规划，无需 API 密钥。可自托管 Valhalla，以获得无限查询；也可使用 L402 Lightning 额度访问我们的托管端点。

工具

工具描述
score-venues按出行时间公平性为 2–10 位参与者评估候选场所
search-venues使用 OpenStreetMap 搜索某地点附近的场所
get-isochrone获取可达范围多边形（N 分钟内可到达的所有地点）
get-directions获取两点之间的路线，并提供逐向导航步骤
store-routing-credentialsLightning 付款后存储 L402 macaroon 和 preimage

快速开始

将以下内容添加到 MCP 客户端配置中（Claude Code、Claude Desktop、Cursor 等）：

{
  "mcpServers": {
    "rendezvous": {
      "command": "npx",
      "args": ["rendezvous-mcp"]
    }
  }
}

然后询问 AI：“Alice 在伦敦、Bob 在布里斯托尔、Carol 在伯明翰，他们在哪里见面吃午餐比较公平？”

远程（HTTP/SSE）

适用于 ChatGPT、远程 AI Agent，或任何通过 HTTP 连接的客户端：

TRANSPORT=http npx rendezvous-mcp

这会在端口 3002 上启动 Streamable HTTP 服务，MCP 端点为 /mcp。

ChatGPT 连接器

在 ChatGPT 设置中添加 MCP 服务：

  • URL： http://your-host:3002/mcp
  • 传输方式： Streamable HTTP

配置

变量默认值描述
TRANSPORTstdio传输模式：stdio 或 http
PORT3002HTTP 服务端口（仅 HTTP 模式）
HOST0.0.0.0HTTP 绑定地址（仅 HTTP 模式）
VALHALLA_URLhttps://routing.trotters.cc路线规划引擎 URL
OVERPASS_URL公共端点场所搜索 API

自托管路线规划

如需无限查询且不受速率限制，可运行自己的 Valhalla 实例：

{
  "mcpServers": {
    "rendezvous": {
      "command": "npx",
      "args": ["rendezvous-mcp"],
      "env": {
        "VALHALLA_URL": "http://localhost:8002"
      }
    }
  }
}

工作原理

  1. 用户询问“我们该在哪里见面？”
  2. AI 对参与者的位置进行地理编码
  3. AI 调用 search-venues，查找该区域附近的候选场所
  4. AI 使用参与者和候选场所调用 score-venues——返回按排名排序的结果，并附上出行时间和公平性评分
  5. AI 提供最公平的选项，并列出每个人的出行时间

如需深入分析，AI 可以使用 get-isochrone 将可达范围可视化，并使用 get-directions 获取逐向导航。

L402 付款

默认路线规划端点（routing.trotters.cc）提供免费请求。免费额度用尽后，工具会返回带有 Lightning 发票的 payment_required 响应。付款后，调用 store-routing-credentials，为本次会话存储 macaroon。

自托管的 Valhalla 无需付款。

架构

这是一个精简的 MCP 封装层，基于 rendezvous-kit 构建——这是一个用于等时圈交集、场所搜索和公平性评分的开源 TypeScript 库。每个工具都由一个可独立提取的处理函数（无需 MCP 即可测试）和一行注册代码组成。

开发

npm install
npm run build
npm test

许可

MIT

支持

如有问题或功能请求，请参阅 GitHub Issues。

如果你觉得 rendezvous-mcp 很有用，可以考虑打赏：

  • Lightning： [email protected]
  • Nostr 打赏： npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。