关于 🪷 Lotus Wisdom MCP Server
Lotus Wisdom 是一款基于《法华经》启发的框架进行引导式问题求解的 MCP 服务,适用于需要多角度分析、反思停顿和明确思考步骤的问题。
主要功能
- 01采用多种问题求解视角
- 02跟踪步骤和智慧领域变化
- 03支持可选的冥想停顿
- 04提供结构化工具输出和模式
- 05呈现交互式思考旅程可视化
适用场景
- 01从多个角度探讨复杂问题
- 02整合看似矛盾的观点
- 03完成引导式反思探究
- 04回顾一次沉思的各个步骤
MCP 相关
该服务提供 `lotuswisdom` 和 `lotuswisdom_summary` 工具,以及 `contemplate` 和 `deep-inquiry` MCP 提示词。它支持本地 stdio 调用和托管远程端点。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://lotus-wisdom-mcp.linxule.workers.dev/mcpclaude mcp add --transport http lotus-wisdom https://lotus-wisdom-mcp.linxule.workers.dev/mcp{"mcpServers":{"lotus-wisdom":{"type":"http","url":"https://lotus-wisdom-mcp.linxule.workers.dev/mcp"}}}在 Cursor 中打开{"servers":{"lotus-wisdom":{"type":"http","url":"https://lotus-wisdom-mcp.linxule.workers.dev/mcp"}}}在 VS Code 中打开{"mcpServers":{"lotus-wisdom":{"type":"http","url":"https://lotus-wisdom-mcp.linxule.workers.dev/mcp"}}}{"mcpServers":{"lotus-wisdom":{"serverUrl":"https://lotus-wisdom-mcp.linxule.workers.dev/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
2| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| tag | enum | 是 | 当前处理技术(智慧领域标签)begin | upaya | expedient | direct | gradual | sudden | recognize | transform | integrate | transcend | embody | examine | reflect | verify | refine | complete | open | engage | express | meditate |
| content | string | 是 | 此步骤的思考内容 |
| stepNumber | integer | 否 | 当前步骤编号 |
| totalSteps | integer | 否 | 预计所需的总步骤数(可随进展调整) |
| isMeditation | boolean | 否 | 此步骤是否为冥想暂停 |
| nextStepNeeded | boolean | 否 | 是否需要另一个步骤 |
| previousJourney | string | 否 | 传入上一个响应中的 journey 字符串,以持续跟踪 journey(例如 "begin → open → examine")。 |
| meditationDuration | integer | 否 | 冥想暂停的时长,单位为秒(1-10) |
详细介绍
🪷 Lotus Wisdom MCP Server
一个 MCP 服务实现,提供基于《法华经》智慧框架解决问题的工具,将分析性思维与直觉智慧相结合。
可通过以下地址访问:https://lotus-wisdom-mcp.linxule.workers.dev/mcp
功能
- 受《法华经》启发的多角度问题解决方法
- 运用不同思维技巧的逐步思考过程
- 通过冥想暂停,让洞见自然浮现
- 交互式可视化,通过 MCP ext-apps 支持(Claude Desktop、Cursor、ChatGPT)——一个像素光环,每一步点亮一个分段,并提供适配宿主主题的夜间和日间版本;支持键盘访问,并遵循减少动态效果的设置
- 用于单步引导式观照会话的 MCP 提示词(
contemplate、deep-inquiry) - 与文本回复并列提供的 结构化工具输出(
structuredContent+outputSchema) - 同时追踪标签历程和智慧领域的变化
- 可作为本地 stdio 包(
npx)使用,也可作为托管的远程 Connector 使用 - 将洞见最终整合为清晰的回复
背景
此 MCP 服务基于 Lotus OS 提示词开发,该提示词旨在实现一种基于《法华经》的认知框架。MCP 服务格式让此框架更易于访问,也更便于与 Claude 和其他 AI 助手搭配使用。
MCP 服务通过工具和提示词提供此框架。模型遵循此框架的程度取决于模型和宿主。
实现细节
此服务采用受《法华经》启发的智慧领域,实现了结构化思考过程:
智慧领域与标签
服务使用智慧领域组织思路(以下均为 tag 输入参数的有效值):
-
入门(🚪):
begin- 从这里开始你的旅程——在观照开始前接收完整框架
-
善巧方便(🔆):
upaya、expedient、direct、gradual、sudden- 通往真理的不同方式——有时直接指出,有时逐渐展开
-
非二元认知(☯️):
recognize、transform、integrate、transcend、embody- 觉醒于已然存在之物的不同方面——认知本身就是转化
-
元认知(🧠):
examine、reflect、verify、refine、complete- 心智观察自身理解逐步展开
-
过程流转(🌊):
open、engage、express- 一种自然的脉络,可涵盖上述任意方法
-
冥想(🧘):
meditate- 暂停片刻,让洞见从静定中浮现
思考可视化
在支持 MCP ext-apps 的客户端中,每一步都会以内嵌交互式光环的形式呈现(参见下文的交互式可视化)。所有客户端的每一步还会返回:
- 展示标签路径和智慧领域变化的历程追踪
- 特定领域的标签和当前观照文本
- 面向程序化使用者的结构化输出(
structuredContent+outputSchema)
注意:使用本地 stdio 服务时,若设置 LOTUS_DEBUG=true,服务可向控制台(stderr)输出逐步追踪行,帮助开发者跟进思考过程。
过程流转
- 用户提交要解决的问题
- 模型以
tag='begin'开始,以接收完整框架 - 模型继续使用观照标签(open、examine、integrate 等)
- 每个思考都以之前的思考为基础,并可能修正理解
- 工具同时追踪标签历程和智慧领域的变化
- 可加入冥想暂停,以帮助理清思路
- 返回
status='WISDOM_READY'时,表示工具已完成工作 - 随后,模型会用自己的表达自然地阐述最终智慧
可用工具
lotuswisdom
运用《法华经》的智慧框架解决问题,并提供多种理解问题的方法。
使用 tag='begin' 开启探索之旅——这会返回完整的框架(哲学、领域、指导),为你的思考奠定基础。然后继续使用其他标签。
输入:
tag(字符串,必填):当前处理技巧(必须是上面列出的标签之一)content(非空字符串,必填):当前处理步骤的内容,包括beginstepNumber(整数,可选,默认值为1):当前步骤序号totalSteps(整数,可选,默认值为5):预计所需的总步骤数nextStepNeeded(布尔值,可选,默认值为true):是否需要继续下一步isMeditation(布尔值,可选):此步骤是否为冥想暂停meditationDuration(整数,可选):冥想时长,单位为秒(1-10)previousJourney(字符串,可选):先前响应中的journey字符串,例如"begin → open → examine"。在无状态客户端(例如远程 Worker)中,此参数可让 AI 延续探索之旅,因为服务端不保存会话状态。
**返回:**一个 JSON 文本块和经过 outputSchema 验证的 structuredContent。每个成功响应都包含用于延续探索之旅的 journey,包括 begin 和完成时的响应。完成时还会保留 finalJourney,以保持兼容性。其他结果变体会在两种表示形式中保留其字段。
当 nextStepNeeded: false 时,冥想步骤会以 WISDOM_READY 完成探索。仍在进行中的冥想步骤会返回 MEDITATION_COMPLETE。
响应状态包括:
- 包含当前步骤信息、智慧领域和探索追踪信息的处理状态
begin步骤的FRAMEWORK_RECEIVED状态- 冥想步骤的
MEDITATION_COMPLETE状态 - 沉思过程完成时的
WISDOM_READY状态
此工具声明了 readOnlyHint、idempotentHint、destructiveHint: false 和 openWorldHint: false。这些是宿主提示,并不保证完全没有副作用:本地 stdio 调用会更新内存中的探索记录,托管 Worker 会记录使用分析数据。这些工具不会修改用户文件或外部业务数据。
lotuswisdom_summary
获取当前沉思之旅的摘要。
输入:
previousJourney(字符串,可选):先前响应中的journey字符串,用于在无状态客户端中重建摘要。
返回:
- 探索之旅的长度
- 展示智慧领域间变化的领域探索路径
- 所有步骤的摘要,包括标签、领域和简要内容
MCP 提示词
服务会注册两个提示词,用于搭建引导式沉思会话(在支持 MCP Prompts 的客户端中显示为斜杠命令或提示词选择器):
contemplate— 参数question:开启针对单个问题的沉思,并指示模型从tag='begin'开始、逐步推进,且仅在status='WISDOM_READY'后阐述智慧。deep-inquiry— 参数topic:开启一段更深入的探索,有计划地穿行于各个智慧领域(过程 → 元认知 → 非二元 → 冥想)。
用法
Lotus Wisdom 工具适用于:
- 分解需要多角度理解的复杂问题
- 适合采用直接和渐进式方法的问题
- 需要整合表面矛盾的问题
- 需要兼顾分析与直觉理解的情境
- 适合通过冥想暂停来获得洞见的任务
- 蕴含内在智慧的问题
示例用法
以下是使用 Lotus Wisdom MCP 服务时,与 Claude 的对话可能呈现的流程:
用户:“帮我理解自由与责任之间的关系。”
Claude 会先使用 tag='begin' 开启旅程,以获取框架,然后继续:
- 首先,进入沉思空间:
{
"tag": "begin",
"content": "Entering contemplation on freedom and responsibility.",
"stepNumber": 1,
"totalSteps": 6,
"nextStepNeeded": true
}
→ 返回包含完整框架的 FRAMEWORK_RECEIVED
- 然后,提出一个开场想法:
{
"tag": "open",
"content": "The question explores the relationship between freedom and responsibility, which contain an apparent tension but also deep connection.",
"stepNumber": 2,
"totalSteps": 6,
"nextStepNeeded": true
}
- 从不同视角进行探讨:
{
"tag": "direct",
"content": "Freedom and responsibility are two sides of the same coin. True freedom isn't absence of constraints but the capacity to choose our response within constraints.",
"stepNumber": 3,
"totalSteps": 6,
"nextStepNeeded": true
}
- 或许可以稍作冥想:
{
"tag": "meditate",
"content": "Contemplating how freedom without responsibility becomes chaos, and responsibility without freedom becomes oppression.",
"stepNumber": 4,
"totalSteps": 6,
"nextStepNeeded": true,
"isMeditation": true
}
- 整合理解:
{
"tag": "integrate",
"content": "Freedom and responsibility mutually enable each other. Our freedom to choose gives rise to our responsibility for what we choose, and our willingness to take responsibility expands our freedom.",
"stepNumber": 5,
"totalSteps": 6,
"nextStepNeeded": true
}
- 表达最终的理解:
{
"tag": "express",
"content": "The paradox resolves when we see that authentic freedom includes responsibility as its natural expression.",
"stepNumber": 6,
"totalSteps": 6,
"nextStepNeeded": false
}
当工具返回 status: 'WISDOM_READY' 时,Claude 会自然地表达最终智慧,并融入沉思之旅中的所有见解。
安装
通过 Smithery 一键安装,或按照下方的手动说明操作。
需要 Node.js 18 或更高版本。服务通过 npx 在本地运行。
CLI 安装(一行命令)
# Claude Code
claude mcp add lotus-wisdom -- npx -y lotus-wisdom-mcp
# Codex CLI (OpenAI)
codex mcp add lotus-wisdom -- npx -y lotus-wisdom-mcp
# Gemini CLI (Google)
gemini mcp add lotus-wisdom npx -y lotus-wisdom-mcp
Claude Desktop
添加到你的 claude_desktop_config.json:
| 操作系统 | 配置路径 |
|---|---|
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Linux | ~/.config/Claude/claude_desktop_config.json |
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
VS Code
添加到 .vscode/mcp.json(工作区),或打开命令面板 > MCP: Open User Configuration(全局):
{
"servers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
注意:VS Code 使用
"servers"作为顶层键,而不是"mcpServers"。其他 VS Code 分支版本(Trae、Void、PearAI 等)通常也使用相同格式。
Cursor
添加到 ~/.cursor/mcp.json(全局)或 .cursor/mcp.json(项目):
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
Windsurf
添加到 ~/.codeium/windsurf/mcp_config.json(Windows:%USERPROFILE%\.codeium\windsurf\mcp_config.json):
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
Cline
在 Cline 面板中打开 MCP Servers 图标 > Configure > Advanced MCP Settings,然后添加:
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
Cherry Studio
在 Settings > MCP Servers > Add Server 中,将 Type 设为 STDIO,Command 设为 npx,Args 设为 -y lotus-wisdom-mcp。或者在 JSON/Code 模式下粘贴:
{
"lotus-wisdom": {
"name": "Lotus Wisdom",
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"],
"isActive": true
}
}
Witsy
在 Settings > MCP Servers 中添加新服务,设置 Type:stdio,Command:npx,Args:-y lotus-wisdom-mcp。
Codex CLI(TOML 配置)
也可以直接编辑 ~/.codex/config.toml:
[mcp_servers.lotus-wisdom]
command = "npx"
args = ["-y", "lotus-wisdom-mcp"]
Gemini CLI(JSON 配置)
也可以直接编辑 ~/.gemini/settings.json:
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "lotus-wisdom-mcp"]
}
}
}
Windows
在 Windows 上,npx 需要一个 shell 包装器。将 "command": "npx" 替换为:
{
"command": "cmd",
"args": ["/c", "npx", "-y", "lotus-wisdom-mcp"]
}
对于 Windows 上的 CLI 工具:
claude mcp add lotus-wisdom -- cmd /c npx -y lotus-wisdom-mcp
codex mcp add lotus-wisdom -- cmd /c npx -y lotus-wisdom-mcp
ChatGPT
ChatGPT 仅支持通过 HTTPS 连接远程 MCP 服务。请使用 Smithery,或通过 ChatGPT Settings > Connectors 直接连接下方托管的实例。
远程(托管)
可使用公共实例:https://lotus-wisdom-mcp.linxule.workers.dev/mcp。无需 API 密钥。
对于支持 Streamable HTTP 的客户端,可直接连接该 URL。对于仅支持 stdio 的客户端,请使用 mcp-remote:
{
"mcpServers": {
"lotus-wisdom": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://lotus-wisdom-mcp.linxule.workers.dev/mcp"]
}
}
}
如需自托管实例,请参阅 worker/README.md。
从源代码构建
使用 Bun 1.4.2 和 Node.js 24,以与 CI 保持一致。
bun install --frozen-lockfile
bun run typecheck
bun run test
bun run build
bun run test:package
bun run start
构建会安装应用锁定的依赖,并重新生成已纳入版本控制的
dist/bundle.js 和 dist/journey.html 构建产物。使用
cd app && bunx tsc --noEmit && bun run test 检查应用。测试套件涵盖单文件
构建(本地 Vite 插件会将 JavaScript 和 CSS 内联到单个 HTML 资源中;
测试会覆盖动态导入和 HTML 转义),以及旅程本身:
帧间连贯性、冥想、每次询问之间的重置、仅探索已完成的面板,以及
根据嵌入的轮廓渲染每个标签的字符。worker 类型检查、试运行构建和本地 HTTP 回归测试,请参阅
worker 验证。
如需像聊天中那样逐帧查看旅程,每次调用显示一帧,请运行
cd app && bunx vite build 并打开 app/preview.html。光环中的字符
在 app/src/glyphs.ts 中生成;app/scripts/glyphs.py 可根据 Noto Serif TC 子集重新生成
这些字符,并说明了如何获取该子集。
bun run test:package 会打包已构建的文件,在临时
使用方目录中安装 tarball,并启动 npm 的可执行文件链接。它会检查 MCP 版本、
工具发现、以冥想结束的完整询问、新询问的重置,以及打包后的旅程 HTML。CI 会在构建后、
发布前运行此检查,因此,启动器损坏或缺少软件包资源都会阻止发布。安装生产依赖需要访问 npm 注册表;检查完成后会删除临时文件。
Dependabot 对根目录、应用和 worker 软件包使用 bun 生态系统,以便更新包含它们的 bun.lock 文件。CI 会在拉取请求中验证全部三个软件包。合并 PR 只会更新源代码:版本标签会发布到 npm 和 MCP Registry,而 Cloudflare Worker 需要单独部署。
如果 npm 发布成功,但 MCP Registry 注册失败,只需针对现有标签重试注册:
gh workflow run publish-mcp.yml --ref main -f registry_tag=vX.Y.Z
将 vX.Y.Z 替换为已发布版本的现有标签。此操作会重新验证
标签对应的源代码,并等待 npm 上可用后再进行注册。它不会重新发布 npm,也不会移动发布标签。
启用调试模式:
LOTUS_DEBUG=true bun run start
交互式可视化(ext-apps)
在支持 ext-apps 的 MCP 客户端(Claude Desktop、Cursor、ChatGPT)中,每个步骤都会以内嵌小面板的形式呈现:一个由像素组成的圆环,设计灵感来自寺庙佛像背后连接的 LED 光背;圆环中央是该步骤对应的汉字,旁边则是观照内容。每次工具调用都会生成自己的面板,因此一段旅程会在对话中逐帧向下展开。
- 圆环:每个步骤对应一个圆环分段,并用 ASCII 明暗字符表示:▒ 表示预计尚未到来的步骤,▓ 表示之前的步骤,实心 █ 表示当前步骤,随着步骤到来逐渐显现。
totalSteps变化时,圆环会重新划分;旅程完成时,圆环恰好闭合。 - 颜色代表专注:只有当前步骤呈现彩色,其余部分都是墨色。颜色取自佛教旗帜上的六种佛光:Entry 为白色,Process 为红色,Skillful Means 为黄色,Non-Dual 为橙色,Meta-Cognitive 为蓝色,Meditation 则是旗帜上的第六条色带,由五种颜色的像素拼成。圆环闭合时会变成白色,所有颜色同时呈现(如同白昼中的墨色)。
- 每个标签对应一个汉字:每个汉字都取自鸠摩罗什译《法华经》或天台宗对该经的解读,并采用繁体字形。open、express、recognize 和 embody 对应第二品“方便品”中佛出世的四个目的——開示悟入;该品还提供了巧(upaya:巧說諸法,即“善巧地阐述教法”)和直(direct:正直捨方便,即“直接舍弃方便法门”)。照(reflect)指第一品中照耀一万八千世界的光,出(transcend)指第三品中离开火宅的孩子,證(verify)指第十一品中多宝佛作证,淨(refine)指第十九品中清净的感官。examine 和 meditate 则构成天台的止觀。将鼠标悬停在汉字上,可查看其拼音和出处。汉字采用嵌入的 Noto Serif TC 字体轮廓(SIL OFL 1.1)绘制,因此无论是否安装 CJK 字体,显示效果都相同。
- 冥想:冥想分段会通过像素密度呼吸三次,然后静止。
- 完成:圆环逐段闭合并变成白色。下方不会添加任何内容。
- 回顾:只有已完成的面板可以交互。将鼠标悬停在某个分段上或聚焦该分段,即可查看该步骤及其对应颜色、汉字和标签;点击或按 Enter 可将其固定;使用方向键浏览圆环。仍在进行的步骤面板仅供阅读,不响应指针操作。之前帧中保留的步骤会显示其位置;步骤文字仍留在对应帧中。
- 设计力求安静:不会循环播放任何效果,也不会发光;启用
prefers-reduced-motion时,所有状态都会立即显示,不带动画。这个设计源自 Lotus Wisdom 在自身界面中的一次旅程;运行cd app && bunx vite build后,打开app/preview.html,即可像聊天中那样逐次调用、逐帧重播这段旅程。
不支持 ext-apps 的客户端不受影响——它们仍会收到与之前相同的 JSON 工具响应。
工作原理
Lotus Wisdom 框架认识到,智慧往往并非来自线性思考,而是在不同理解方式之间的交融中涌现。该工具通过以下方式促进这一过程:
-
追踪智慧领域:随着你使用不同标签,该工具会追踪你所涉足的智慧领域,帮助你看清探究的脉络。
-
旅程意识:该工具会持续了解你的完整旅程,展示所用标签的顺序,以及智慧领域之间的流动。
-
非线性进展:虽然步骤带有编号,但过程并非严格线性。随着理解加深,你可以回访、修订,也可以分支探索。
-
整合节点:
integrate、transcend和embody等标签有助于将洞见编织在一起,而非彼此割裂。 -
自然表达:该工具负责处理观照过程,但最终的智慧始终由 AI 自然表达,而非以格式化输出呈现。
Token 优化设计
MCP 工具描述会在服务连接期间始终占用 AI 的上下文窗口。为了尽可能降低这部分开销,同时保留完整的教学内容:
- 常驻上下文(约 150 个 token):
lotuswisdom工具描述保持精简,只包含 AI 了解何时以及如何使用它所需的信息 - 按需学习(约 1,200 个 token):使用
tag='begin'调用时提供完整框架,包括:- 哲学理念和领域精神
- 参数说明(tag、content、stepNumber 等)
- 响应格式详情(wisdomDomain、journey、domainJourney)
- 冥想处理(MEDITATION_COMPLETE 状态)
- 何时使用引导
- 先学习,再实践:
begin标签确保模型在开始思考前充分理解内容
这种方法可在工具空闲时将常驻上下文开销减少约 85%。实际使用时,完整框架会在第一步调用时提供,不会遗漏任何内容。
许可证
此 MCP 服务采用 MIT 许可证。详情请参阅项目仓库中的 LICENSE 文件。
参与贡献
欢迎贡献!欢迎在 GitHub 仓库中提交问题或拉取请求。
版本
当前版本:0.9.0
0.9.0 新增内容
- 将旅程可视化重新设计为像素光环:每一步对应一个分段,中心显示一个汉字,旁边显示思考内容。已完成的步骤以墨色显示,后续步骤显示为暗淡轨迹,当前步骤使用其所属领域的颜色。夜间主题下,完成的圆环会变为白色。
- 加入内嵌的 Noto Serif TC 字形轮廓,悬停时显示拼音和来源注释,因此无需安装 CJK 字体或请求字体,汉字也能正常显示。
- 为每个事件添加有限时长的动画,并且只有已完成的面板支持通过悬停、聚焦、固定和键盘导航进行探索。
- 回顾时保持已完成面板的高度稳定;较长的早期文本可在面板内滚动,并修复了快速悬停时内容淡出竞态问题。
- 添加适配宿主主题的日间配色、减少动态效果样式、DOM 回归测试,以及每次工具调用显示一帧的开发预览。
- 包含下方的旅程可靠性和依赖项安全修复;0.8.6 已准备就绪,但未单独发布。
为 0.8.6 准备的可靠性修复(已包含在 0.9.0 中)
- 通过从
begin返回连续性元数据(包括结构化输出),在无状态旅程中保留开场步骤。 - 修复冥想步骤的完成处理,并在完成响应中添加
journey,同时保留finalJourney。 - 在重复使用的 iframe 中切换咨询时重置可视化内容,包括待处理的动画、折叠步骤、固定项和完成效果。
- 为已安装的 CLI 和 worker 添加基于响应的旅程回归测试,并添加连续咨询和动画竞态的 DOM 测试。
- 更新依赖项并修补存在漏洞的传递依赖包。在 Wrangler 的 Miniflare 依赖得到修补之前,worker 会临时覆盖 Undici。
0.8.1 新增内容
- 更新依赖项和 GitHub Actions,重新生成 Bun 锁文件,并在 CI 中加入应用和 worker 验证。
- 更新所有三个软件包中存在漏洞的传递依赖项,并在 CI 中加入依赖项审计。2026 年 9 月 14 日的发布验证期间,三个 Bun 审计均已通过。
- 将可视化迁移到 ext-apps 2,并使用其 MCP 客户端 v2 和 Zod 4 依赖项。服务传输仍使用 MCP SDK v1;worker 使用 agents SDK 提供的显式兼容性处理器,并保留无状态 JSON 响应。
0.8.0 版本更新
- 单一事实来源:领域逻辑、工具/服务元数据、提示词和客户端解析器现已统一放在
src/shared/中,由 stdio 入口(index.ts)和 Cloudflare Worker 共用,避免本地与远程版本出现偏差 - 全面采用高级
McpServer:本地 stdio 服务已从低级ServerAPI 迁移到McpServer,与 Worker 保持一致 - MCP 提示词:新增用于引导式沉思练习的
contemplate和deep-inquiry - 结构化工具输出:工具现在会返回经过
outputSchema验证的structuredContent,以及行为注释(readOnlyHint、idempotentHint、destructiveHint: false、openWorldHint: false)和服务的instructions字段 - 主题感知且易于访问的 UI:ext-apps 旅程可视化会适配宿主的浅色/深色主题,并支持键盘操作
- 安全与清理:将
@modelcontextprotocol/sdk升级到^1.27.1,添加zod,移除chalk;移除旧版 Express SSE 服务(server.ts)、express依赖和Dockerfile;仓库改用 bun 锁文件。新增 vitest 测试套件(tests/)和单一来源的版本工作流(src/shared/version.ts+bun run sync-version) - 服务图标与网站:
server.json通过remotes[]声明远程 Worker、通过websiteUrl声明网站,并列出图标的sizes;Worker 会在 initialize 握手中声明图标/网站,并以同源字节形式在/icon.png提供图标
0.7.0 版本更新
- 完全无状态的 Worker:移除 Durable Object — 远程 Worker 现在会为每个请求创建一个全新的服务,并依靠客户端提供的
previousJourney参数维持旅程连续性(消除了 SSE 累积运行时间)
0.6.0 版本更新
- 服务图标:在
server.json和 Worker 中添加图标,让 MCP Registry 和 claude.ai Connectors 显示莲花标志 - 更温暖的 UI,以及(后来已撤销的)实验性 Durable Object 会话状态
0.5.0 版本更新
- 发布到 npm + MCP Registry:完善打包,并发布到 npm 和官方 MCP Registry
0.4.0 版本更新
- 交互式可视化:MCP ext-apps UI 会在受支持的客户端(Claude Desktop、Cursor、ChatGPT)中内嵌渲染「Living Trace」旅程
- 完成状态修复:任何
nextStepNeeded=false的标签现在都会正确返回WISDOM_READY(此前只有express和complete可以完成) - Cloudflare Worker:更新 Worker 部署,支持提供 ext-apps 资源
0.3.2 版本更新
- 🚪 简化开始操作:现在只需调用
{"tag":"begin"}即可使用tag='begin'— 其他所有参数都会自动填充 - 🤖 更好地支持 Haiku/小型模型:降低模型无法推断所有必需参数时的使用障碍
0.3.1 版本更新
- 📚 全面学习框架:
begin标签现在会返回完整的参数说明、响应格式详情和冥想处理方式 - 🔢 准确的令牌数量:更新文档,列出实际令牌数(约 150 个固定令牌,按需约 1,200 个)
0.3.0 版本更新
- 🚪 Begin 标签:新增
tag='begin',用于开启旅程 — 在沉思开始前返回完整框架 - ⚡ 优化令牌占用:在保留完整教学内容的同时,将固定上下文开销从约 1,400 个令牌降至约 200 个
- 🧘 先学习,再练习:
begin标签确保模型在开始沉思前获得完整理解 - 📦 更新 SDK:将 @modelcontextprotocol/sdk 升级到 1.23.0
0.2.1 版本更新
- 📋 增强 MCP Registry 信息:添加
title字段,提升可发现性 - 🎯 完全合规:现已完全符合官方 MCP 发布指南
- 🔗 Registry 链接:现已可在官方 MCP Registry中查看
0.2.0 版本新增内容
- 🌐 支持 HTTP 传输:现在可部署在 smithery.ai 和其他基于 HTTP 的平台上
- 🔄 双重传输:为 npm/CLI 用户保留 stdio 支持,同时新增 HTTP 传输方式,支持远程部署
- 📦 更新 SDK:升级至支持 Streamable HTTP 的 @modelcontextprotocol/sdk 1.20.1
- 🪷 全新 Logo:终端美学风格的莲花 Logo,非常适合开发者工具
- ⚡ 会话管理:HTTP 版本包含完整的会话管理功能,支持有状态的智慧之旅
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。