yanxiangjun MCP连接说明

yanxiangjun MCP 是一个只读的 MCP（Model Context Protocol）服务，正式地址是 https://ai.yanxiangjun.cn/ 。它面向 AI 客户端提供旅游业务资料、本站已公开内容与观点依据；服务端只返回材料与回答组织规则，最终答案由客户端 Agent 自己组织。

这个服务提供什么

服务的主题范围是旅游信息传播、目的地营销、旅游信息化、旅游职业教育，以及 AI 在旅游业中的应用。它可以返回本站已公开的文章、视频、音频、图片类讲解与技能目录条目及摘录，也可以按问题返回个人知识库与业务知识库中与主题相关的有限摘录，并附出处线索、年代线索与使用规则。服务是只读的：不生成最终答案，不发布、不删除内容，不提供私有资料批量导出，也不能远程操控本站网页里的游戏或交互程序。

提问时请提交一段完整的问题，保留人名、评价意图和旅游或职业语境；追问时补上必要语境并重新查询，不要用上一轮的旧答案代替本轮查询。关于某位人物的评价、某类事件的评论，服务会自行核验主题范围，只在旅游业务与旅游职业教育范围内返回材料。

连接方式

连接地址就是根地址 https://ai.yanxiangjun.cn/ ，传输方式为 Streamable HTTP，请求体是 MCP 的 JSON-RPC 消息，请求头的 Host 必须是 ai.yanxiangjun.cn。网址上不接受查询参数，带参数会返回 400。单次请求 60 秒超时，反向代理同时限制请求体最大 16 KB。浏览器跨域请求只允许来自 https://ai.yanxiangjun.cn 与 https://www.yanxiangjun.cn 两个来源，其他来源返回 403，预检请求会返回允许的方法与请求头清单。认证成功后，请通过 tools/list 读取当前工具真实可用的输入结构。

密钥申请与鉴权

本服务不提供 OAuth 授权流程，也不签发匿名访问，所有工具与规则资源都需要获批密钥。使用前请先在主站 https://www.yanxiangjun.cn/ 提交申请，人工审定通过后获得一枚 Bearer 密钥；调用时把它放在请求头里，形如 Authorization: Bearer 你的密钥。密钥不要写进网址、公开文件、代码仓库或日志。只支持 OAuth 而没有自定义请求头能力的客户端，需要先做一次适配。机器可读的服务描述在 mcp.json，其中同样写明认证类型为 bearer、必须审批、不支持 OAuth。

没有密钥访问根地址会返回 401，响应头带 WWW-Authenticate: Bearer realm="yanxiangjun"；普通浏览器以无认证的 HTML 方式打开根地址，会跳转到主站申请页——这个跳转只是给人类看的入口，不代表 MCP 已经连接，也不代表服务免认证。密钥申请、审批与已有申请数据由主站管理，本服务不重置、不导出、不公开任何申请记录。

可用的工具

ask_laoyan 用来提交完整问题，返回与问题相关的公开内容、两库必要摘录、出处线索和回答组织规则；它需要真实查询当前索引，不能靠旧答案替代，任一知识库不可用或本题查询未完成时不会给出评论材料。get_catalog 用来查看当前获准的内容类型、栏目与可用状态，便于确认某个栏目现在有没有资料；它不提供私有资料名单。两个工具的实际参数与返回结构以认证后 tools/list 的结果为准，本文不重复声明字段结构，以免与运行中的服务不一致。

额度与限制

单次提问最多读取 80 个索引块，最多返回 12 条个人知识库摘录，摘录总量不超过 9000 字符；公开内容的读取同样在有限预算内完成。频次限制按分钟计算：同一密钥每分钟最多 40 次请求，同一来源 IP 每分钟最多 120 次请求，超过时返回 429 并提示 rate_limited。公开栏目目录各有读取上限，例如目的地与指南目录每轮最多读取 12 个条目，目的地漫画目录最多 60 项；达到上限时服务会明确报告覆盖不足，不会把上限内结果说成完整清单。

公开的内容与机器文件

不需要密钥就能阅读的公开入口有几个：人类访问主页在 ni.yanxiangjun.cn，全站机器入口是 ai-manifest.json，公开内容索引是 ai-index.json，网站阅读指南是 llms.txt，当前公开技能目录是 skills.json。本站自己也提供机器可读文件：mcp.json 是本站自说明格式的服务描述，llms.txt 是纯文本连接说明，robots.txt 与 sitemap.xml 说明抓取范围，health 只报告服务是否在线及版本。

隐私与使用边界

公开目录只包含已经公开的内容，不包含申请记录、密钥、未发表稿件，也不提供私有知识库全文或批量导出。个人知识库的摘录经过披露限额与来源隐藏处理，不展示资料名称、内部路径与块标识；没有文字稿的媒体只提供真实简介以及播放或原图链接，不声称理解完整媒体内容。

涉及具体目的地、城市、景区或景点时，服务只查询本站 DMS 目的地资料、司南目的地指南、画说目的地漫画和胜引导览四栏，逐栏回答找到、未找到或暂时无法读取；没有资料时如实说明，不搜索其他渠道，也不用模型常识补齐地点事实。此类答复末尾会保留提示：老闫提供的目的地信息仅用于旅游业应用 AI 的试验，如出游采用应再次核实。

常见状态码

401 表示没有携带密钥或密钥无效；403 表示请求来源不在允许列表；404 表示该路径不存在，本站对外只有本文列出的公开文件与接口；421 表示请求主机名不是 ai.yanxiangjun.cn；429 表示超过每分钟频次限制；503 表示服务暂时不可用，稍后重试即可。