Agentic MCP Itinerary

MCP安全风控

提供方 AlexGHerrera

安全风控 stdio · 本地进程 OAuth 授权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个基于LLM代理(Gemini Flash + LangGraph)的MCP服务器,用于创建和管理旅行行程,包括航班、酒店和活动安排。

一句话选型结论

按资料字段整理

Agentic MCP Itinerary 属于安全风控类 MCP 服务器,stdio · 本地进程,OAuth 授权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式stdio · 本地进程 鉴权OAuth 授权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

旅行规划Python本地部署LLM代理MCP服务器行程管理OAuth认证

安装与配置

stdio · 本地进程 OAuth 授权
客户端在本机拉起子进程,数据不出本机
pip install -e ".[dev]"

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好OAuth 授权对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Agentic MCP Itinerary当前 5 stdio · 本地进程 本地部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AlexGHerrera上游标注的维护方 AlexGHerrera
分类安全风控本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式OAuth 授权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.1 KB
来自项目仓库与上游目录的原文,未做删改

代理MCP行程——PoC

> 一个MCP服务器,内部运行一个LLM代理(Gemini Flash+Langgraph),并协调多个MCP服务器下游。客户端(Claude Desktop,ChatGPT)看到一个干净的界面,在迭代之间保持状态。

概念```

Claude Desktop / ChatGPT
│
│ MCP (HTTP/SSE + OAuth 2.1)
▼
┌─────────────────────────────────────┐
│ travel-agent (este repo) │
│ FastMCP server + LangGraph agent │
│ │
│ ┌──────┐ ┌────────┐ ┌──────────┐│
│ │Vuelos│ │Hoteles │ │Actividad.││ ← MCP mocks STDIO
│ └──────┘ └────────┘ └──────────┘│
└─────────────────────────────────────┘


**为什么这是不同的?** 目前还没有公司提供“封装为MCP服务器的垂直代理”。这个POC展示了这种模式:客户只看到4-5个干净的工具,但背后有一个具有内存、并行扇出和持久状态的代理。

______________________________________________________________________

## 堆栈

|组件|技术|
|---|---|
|暴露的MCP服务器| FastMCP 3.1.1(`streamable-http`) |
| 内部代理 | LangGraph (`StateGraph` +平行扇出)。
|LLM型号|双子座闪光灯(`gemini-2.0-flash`) |
|Auth|OAuth 2.1授权码流+JWT HS256|
|检查点| `MemorySaver` (在内存中,足以进行POC)|
|MCP下游|MCP SDK官方(`mcp.client.stdio`) |
|MOCKS|3 FASTMCP服务器STDIO(航班、酒店、活动)|
|部署|铁路(RAILPACK+pyproject.toml)|

______________________________________________________________________

## 公开工具(公共API)

|工具|参数|描述|
|---|---|---|
| `create_itinerary` | `requirements: str` |创建完整的草稿(航班+酒店+平行活动)|
| `refine_itinerary` | `itinerary_id: str`, `change_request: str` |完善现有草案|
| `get_itinerary` | `itinerary_id: str` |恢复当前状态|
| `list_itineraries` |-|列出所有活动行程|
| `confirm_itinerary` | `itinerary_id: str` |确认并生成 `confirmation_code` |

______________________________________________________________________

## 部署铁路

### 网址

- **健康**: https://travel-agent-production-c1c4.up.railway.app/health
- **MCP端点**: https://travel-agent-production-c1c4.up.railway.app/mcp
- **OAuth元数据**: https://travel-agent-production-c1c4.up.railway.app/.well-known/oauth-authorization-server
- **登录表格**: https://travel-agent-production-c1c4.up.railway.app/oauth/authorize

### ID铁路

- 项目: `e50da57f-ee0b-47a3-81a3-55556fe6de0d`
- 服务: `09065312-ac84-4876-b9c9-dd5d6439f1d4`
- 环境: `09b3f0c9-e5ad-4f61-b351-275bbcffd5ad`

### 所需环境变量

|变量|描述|
|---|---|
| `GEMINI_API_KEY` |API密钥de Google Gemini|
| `MCP_USERNAME` |OAUTH登录用户|
| `MCP_PASSWORD` |OAuth登录密码|
| `MCP_JWT_SECRET` |签名的秘密 `secrets.token_urlsafe(32)`) |
| `MCP_BASE_URL` |服务器的公共URL(用于构建重定向URI)|

______________________________________________________________________

## Auth:Auth2.1授权码流

### 全流程```
1. Claude Desktop detecta el MCP server
2. Descubre /.well-known/oauth-authorization-server
3. Redirige al usuario a /authorize
4. El servidor redirige a /oauth/authorize (form de login HTML)
5. Usuario introduce user/pass → POST /oauth/authorize
6. Servidor valida credenciales (MCP_USERNAME / MCP_PASSWORD)
7. Emite auth code → redirect a Claude Desktop
8. Claude Desktop intercambia code → JWT en /token
9. JWT usado como Bearer en todas las llamadas MCP

实施

  • server/auth.py: SimpleOAuthProvider (延伸) OAuthProvider FastMCP)
  • JWT HS256,1H有效
  • 身份验证代码:5分钟验证
  • PKCE (S256) 支持
  • /health 未经授权公开

配置器Claude桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:```json
{
"mcpServers": {
"travel-agent": {
"type": "http",
"url": "https://travel-agent-production-c1c4.up.railway.app/mcp"
}
}
}


> **罪 `headers`** -Claude Desktop自动管理OAuth流。第一次,它将打开浏览器进行登录。

______________________________________________________________________

## 地方发展

### 要求```bash
pip install -e ".[dev]"

启动服务器```bash

PYTHONPATH=server MCP_USERNAME=alexguerra MCP_PASSWORD=tu_pass \
MCP_JWT_SECRET=dev_secret python3 server/main.py


### 冒烟测试```bash
PYTHONPATH=server python3 tests/smoke_test.py

检查语法```bash

PYTHONPATH=server python3 -m py_compile server/main.py server/auth.py server/agent.py


______________________________________________________________________

## 项目结构```
agentic-mcp-itinerary/
├── server/
│   ├── main.py          # FastMCP server (4 tools + OAuth + /health)
│   ├── auth.py          # SimpleOAuthProvider (OAuth 2.1 + JWT)
│   ├── agent.py         # LangGraph graph con fan-out paralelo
│   ├── state.py         # ItineraryState TypedDict + checkpointer
│   └── tools/
│       ├── flights.py   # Cliente MCP → mock vuelos
│       ├── hotels.py    # Cliente MCP → mock hoteles
│       └── activities.py # Cliente MCP → mock actividades
├── mocks/
│   ├── flights_mcp.py   # Mock server vuelos (FastMCP STDIO)
│   ├── hotels_mcp.py    # Mock server hoteles (FastMCP STDIO)
│   └── activities_mcp.py # Mock server actividades (FastMCP STDIO)
├── tests/
│   └── smoke_test.py    # Test end-to-end básico
├── docs/
│   └── OAUTH_PLAN.md    # Spec del OAuth (referencia de diseño)
├── pyproject.toml       # Deps para RAILPACK
├── railway.toml         # Builder=RAILPACK, startCommand
└── claude_desktop_config.json  # Config para Claude Desktop (sin Bearer manual)

关键决策历史

决定 排除的替代方案 原因
railpack+pyproject.toml nixpacks nixpacks在env不变的情况下在pip中失败
OAuth 2.1授权代码 静态承载器令牌 Claude Desktop管理本地OAuth;更多生产-准备就绪
内存中的JWT HS256 令牌DB POC-重启之间没有持久状态
FastMCP 3.1.1 OAuthProvider Auth Manual with Starlette FastMCP将Flow与Transport MCP集成
MemorySaver SQLite/Redis 适用于本地 PoC;轻松迁移到SqliteSaver。
双子座闪光 克劳德俳句 法典与人类有证书冲突

下一步(POC后)

  • [ ] 克劳德桌面测试 检查完整的 OAuth 流程
  • [ ] 实际持久性 — SqliteSaver 或在重新启动之间状态的postgres
  • [ ] 下游MCP现实 -用真正的API(Amadeus、Booking等)替换Mocks
  • [ ] 多用户 -用户数据库而不是env vars
  • [ ] 速率限制 -通过令牌JWT
  • [ ] 遥测 -Langsmith或类似的内部追踪剂

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Agentic MCP Itinerary 怎么安装?

在客户端按下面的安装命令接入:pip install -e ".[dev]"。装完在客户端配置里引用同一个包或端点。

Agentic MCP Itinerary 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Agentic MCP Itinerary 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Agentic MCP Itinerary 需要 API Key 吗?

资料标注需要OAuth 授权认证,使用前准备好对应凭据,并按最小权限配置。

Agentic MCP Itinerary 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Agentic MCP Itinerary 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 旅行规划、Python、Claude、LLM代理。具体工具清单以官方文档为准。

Agentic MCP Itinerary 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Agentic MCP Itinerary 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。