mcpField
🪷
🪷 Lotus Wisdom MCP Server

🪷 Lotus Wisdom MCP Server

远程服务
lotus-wisdom-mcp.linxule.workers.devAI 与智能体372 天前更新

关于 🪷 Lotus Wisdom MCP Server

Lotus Wisdom 是一款基于《法华经》启发的框架进行引导式问题求解的 MCP 服务,适用于需要多角度分析、反思停顿和明确思考步骤的问题。

主要功能

  1. 01采用多种问题求解视角
  2. 02跟踪步骤和智慧领域变化
  3. 03支持可选的冥想停顿
  4. 04提供结构化工具输出和模式
  5. 05呈现交互式思考旅程可视化

适用场景

  1. 01从多个角度探讨复杂问题
  2. 02整合看似矛盾的观点
  3. 03完成引导式反思探究
  4. 04回顾一次沉思的各个步骤

MCP 相关

该服务提供 `lotuswisdom` 和 `lotuswisdom_summary` 工具,以及 `contemplate` 和 `deep-inquiry` MCP 提示词。它支持本地 stdio 调用和托管远程端点。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址https://lotus-wisdom-mcp.linxule.workers.dev/mcp
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包
npmlotus-wisdom-mcp0.9.0

工具

2
参数类型必填说明
tagenum是当前处理技术(智慧领域标签)begin | upaya | expedient | direct | gradual | sudden | recognize | transform | integrate | transcend | embody | examine | reflect | verify | refine | complete | open | engage | express | meditate
contentstring是此步骤的思考内容
stepNumberinteger否当前步骤编号
totalStepsinteger否预计所需的总步骤数(可随进展调整)
isMeditationboolean否此步骤是否为冥想暂停
nextStepNeededboolean否是否需要另一个步骤
previousJourneystring否传入上一个响应中的 journey 字符串,以持续跟踪 journey(例如 "begin → open → examine")。
meditationDurationinteger否冥想暂停的时长,单位为秒(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)输出逐步追踪行,帮助开发者跟进思考过程。

过程流转
  1. 用户提交要解决的问题
  2. 模型以 tag='begin' 开始,以接收完整框架
  3. 模型继续使用观照标签(open、examine、integrate 等)
  4. 每个思考都以之前的思考为基础,并可能修正理解
  5. 工具同时追踪标签历程和智慧领域的变化
  6. 可加入冥想暂停,以帮助理清思路
  7. 返回 status='WISDOM_READY' 时,表示工具已完成工作
  8. 随后,模型会用自己的表达自然地阐述最终智慧

可用工具

lotuswisdom

运用《法华经》的智慧框架解决问题,并提供多种理解问题的方法。

使用 tag='begin' 开启探索之旅——这会返回完整的框架(哲学、领域、指导),为你的思考奠定基础。然后继续使用其他标签。

输入:

  • tag(字符串,必填):当前处理技巧(必须是上面列出的标签之一)
  • content(非空字符串,必填):当前处理步骤的内容,包括 begin
  • stepNumber(整数,可选,默认值为 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' 开启旅程,以获取框架,然后继续:

  1. 首先,进入沉思空间:
{
  "tag": "begin",
  "content": "Entering contemplation on freedom and responsibility.",
  "stepNumber": 1,
  "totalSteps": 6,
  "nextStepNeeded": true
}

→ 返回包含完整框架的 FRAMEWORK_RECEIVED

  1. 然后,提出一个开场想法:
{
  "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
}
  1. 从不同视角进行探讨:
{
  "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
}
  1. 或许可以稍作冥想:
{
  "tag": "meditate",
  "content": "Contemplating how freedom without responsibility becomes chaos, and responsibility without freedom becomes oppression.",
  "stepNumber": 4,
  "totalSteps": 6,
  "nextStepNeeded": true,
  "isMeditation": true
}
  1. 整合理解:
{
  "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
}
  1. 表达最终的理解:
{
  "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 框架认识到,智慧往往并非来自线性思考,而是在不同理解方式之间的交融中涌现。该工具通过以下方式促进这一过程:

  1. 追踪智慧领域:随着你使用不同标签,该工具会追踪你所涉足的智慧领域,帮助你看清探究的脉络。

  2. 旅程意识:该工具会持续了解你的完整旅程,展示所用标签的顺序,以及智慧领域之间的流动。

  3. 非线性进展:虽然步骤带有编号,但过程并非严格线性。随着理解加深,你可以回访、修订,也可以分支探索。

  4. 整合节点:integrate、transcend 和 embody 等标签有助于将洞见编织在一起,而非彼此割裂。

  5. 自然表达:该工具负责处理观照过程,但最终的智慧始终由 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 服务已从低级 Server API 迁移到 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 版本包含完整的会话管理功能,支持有状态的智慧之旅

评论

支持 Markdown

第一次接触 MCP?

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

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