模型上下文协议 (MCP)

让外部 AI 助手——包括 Claude Desktop、Cursor、Antigravity、Windsurf 和 VS Code——在本地实时直连您的 Noust 工作区。

官方开源服务器 @noust-app/mcp 提供 100% 本地安全双向通信，使 AI 模型能够理解并实时操作您的笔记、Nexus 自由文本 Markdown 文档和画布结构。

AI 可以在您的工作区中做什么？

告别在对话框中频繁手动复制粘贴笔记，MCP 赋予 AI 自主理解与操作画布的能力：

🔍 智能搜索与咨询：让 AI 助手检索所有笔记、Nexus 页面和目标。模型获取完整内容而无截断，并自动过滤 HTML 标签。
“在我的 Noust 工作区中查找部署清单，并帮我总结未完成的任务。”
✍️ 实时画布创建、编辑与删除：AI 助手可以直接在您屏幕打开的画布上创建新笔记卡片、更新现有文本或直接删除废弃笔记。
“在我的画布上创建一张新笔记，记录我们刚才讨论达成的 3 点核心共识。”
🎯 目标与里程碑自主管理：自主跟踪和推动项目进展。AI 模型可以创建新目标、更新截止日期与优先级、将任务标记为已完成、追加进度更新或删除目标。
“添加一个周五前部署预发布环境的高优先级目标，并将上一个数据库迁移目标标记为已完成。”
📄 全功能 Nexus 文档管理：轻松构建系统化知识库。AI 助手可以创建新的全局 Nexus 文档、追加 Markdown 章节、重写文档内容或删除文档。
“创建一个名为‘API 架构’的新 Nexus 文档，详细记录刚才讨论的接口规范。”
🏷️ 可复用标签与色彩和谐：查询并为看板领域创建自定义色彩标签。AI 助手可以检索当前标签的所有颜色（list_flags），根据要求选择独特的色调（例如与现有标签完全不同的橙色调），或自动计算高对比度的平衡配色。
“列出当前领域的所有标签，并创建一个与现有颜色均不相同的橙色‘代码审查’标签。”
🧭 交互式视觉导航：让 AI 定位看板上的任意内容或浏览文档。Noust 会自动平移画布、调整缩放并以流光高亮目标笔记，或直接打开并聚焦 Nexus 文档。
“帮我在屏幕上找到营销冲刺目标所在的位置。”
🖼️ 支持嵌入图片的多模态视觉：具备视觉能力的模型（Claude 3.5 Sonnet、GPT-4o、Gemini）可以直接解析笔记中内嵌的图片、线框图和架构图。
📦 通过 MCP 资源直接引入上下文：无需执行工具调用，模型与客户端即可通过标准 MCP 资源 URI（noust://）将当前活动工作区的数据、笔记正文或 Nexus 文档直接附加到上下文窗口中。
“在给出优化建议之前，先检查 noust://workspace/active 以了解领域拓扑结构。”
🗂️ 多工作区与跨标签页路由：同时在多个打开的工作区中协作。AI 助手可以检查当前活动的标签页，使用 workspace 参数按名称精确定位特定工作区，或无缝与本地目录锚点交互。
“列出我当前活动的工作区，并在‘Mobile App’工作区中添加一条版本发布笔记。”

双模架构 (在线与离线)

@noust-app/mcp 无论在 Noust 开启还是关闭时均能稳健工作：

离线 / 纯文件模式：当 Noust 处于关闭状态时，MCP 服务器直接读取本地关联文件夹中的 .noust 文件。AI 模型可以在完全脱机状态下检索笔记内容、根据 ID 或引用标识（如 1A1）获取卡片并解析图片。
实时在线桥接模式 (零信任架构)：当 Noust 在 Chromium 浏览器中运行并开启本地同步与 MCP（Menu Shell 中的 Agent 面板）时，轻量级本地 WebSocket 桥 (127.0.0.1:8421) 会自动建立连接，允许外部 AI 实时修改画布和导航定位。

加密工作区

如果 .noust 文件已使用用户密码加密，MCP 服务器仅在 Noust 在浏览器中打开并处于活动状态时工作。通过这种机制，AI 代理无法直接从磁盘读取 .noust 内容，只能且必须通过 MCP 服务器的官方工具进行交互。

多工作区与跨标签页路由

Noust 支持在多个浏览器标签页中同时打开不同的工作区，每个工作区均链接到其独立的本地文件夹。@noust-app/mcp 以清晰可预测的方式处理多工作区环境：

本地工作区锚点：当 MCP 服务器通过 --workspace <文件夹> 启动时，它会检测该目录中的本地 .noust 文件。如果某个浏览器标签页正在同步该工作区，则所有操作默认自动指向该标签页。
单个活动标签页：如果浏览器中只有一个工作区标签页处于活动状态，操作将自动路由至该标签页，无需显式指定工作区参数。
跨标签页消歧 (Disambiguation)：当跨多个浏览器标签页存在多个活动工作区，且客户端在特定工作区目录外部运行（或需要操作其他标签页）时，所有工具均支持可选的 workspace 参数。如果存在歧义，服务器将列出活动工作区名称，并提示助手指定要检查或编辑的工作区。
工作区状态检查：get_workspace_status 工具可报告所有活动浏览器会话、已连接的工作区以及当前默认目标。

标准 MCP 资源 (Resources)

除可执行的工具（Tools）外，@noust-app/mcp 还实现了 Model Context Protocol 官方的资源规范（resources/list 与 resources/read）。这使得 Claude Desktop、Cursor、Antigravity 等兼容客户端无需耗费工具调用，即可直接读取工作区状态或将特定笔记与文档引入 Prompt 上下文：

资源 URI	类型	格式	描述
`noust://workspace/active`	静态	JSON (`application/json`)	当前活动工作区的完整概览：工作区 ID、名称、领域列表、笔记总数、Nexus 文档总数及实时桥接连接状态。
`noust://notes/{noteId}`	动态模板	Markdown (`text/markdown`)	画布笔记的完整 Markdown 内容（含标题、所属领域、画布坐标引用 `1A1` 及正文）。支持通过 `resources/list` 自动枚举。
`noust://documents/{docId}`	动态模板	Markdown (`text/markdown`)	Nexus 自由文本 Markdown 文档的完整内容（含标题与正文）。支持通过 `resources/list` 自动枚举。
`noust://objectives/active`	静态	JSON (`application/json`)	工作区内所有活动目标、里程碑、分类及关联标签的实时 JSON 列表。

资源自动发现与双模连续性

IDE 上下文自动补全：支持 resources/list 的客户端可在资源选择器（如 Cursor 中的 @ 上下文引用或 Claude Desktop 的资源面板）中自动列出当前工作区的所有笔记和 Nexus 文档。
双模连续性：当 Noust 在浏览器中运行且开启桥接时，资源动态反映内存中的实时状态；当 Noust 关闭时，资源直接从本地磁盘的 .noust 文件中读取。

快速配置指南

无需进行全局安装，MCP 客户端会通过 npx 按需调用服务器。

前提条件

计算机上已安装 Node.js >= 18.0.0。
通过自动本地同步将 Noust 工作区关联至本地文件夹。
在 Noust 的 Menu Shell 中的 Agent 面板中启用 MCP 桥接。

1. Claude Desktop

将 noust 添加至 Claude Desktop 配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

json

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/absolute/path/to/your/noust-workspace-folder"
      ]
    }
  }
}

Windows 路径转义说明

在 Windows 环境下的 JSON 配置文件中，路径必须使用双反斜杠（如 "C:\\Users\\YourName\\Documents\\Noust"）或正斜杠（如 "C:/Users/YourName/Documents/Noust"），以避免 JSON 语法解析错误。

2. Cursor IDE

在项目的 .cursor/mcp.json 或全局 Settings > Features > MCP Servers 中添加：

json

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/absolute/path/to/your/noust-workspace-folder"
      ]
    }
  }
}

安全与隐私保护 (零知识架构)

云端 AI 模型与数据隐私提示

虽然 Noust 与 @noust-app/mcp 完全在您的本地计算机上运行（127.0.0.1），并且绝不会向 Noust 服务器上传您的任何笔记或数据，但通过 MCP 工具（search_workspace、get_note、get_document、get_objective 等）读取或检索的任何信息，都会作为 Prompt 上下文传输给您所连接的 AI 助手。

如果您连接的助手使用的是第三方云端模型（例如 Claude/Anthropic、ChatGPT/OpenAI 或 Gemini/Google），则读取的工作区内容将通过互联网发送到该模型供应商的服务器，并受其隐私政策与数据保留条款的约束。

如果您对数据主权有严苛要求或处理高度机密的数据，建议将 MCP 客户端配置为连接本地自托管的大语言模型（例如通过 Ollama、LM Studio 或本地开源模型）。

@noust-app/mcp 严格遵循本地优先的安全架构：

100% 本地回环通信：所有数据传输严格限定在 127.0.0.1，绝不向任何外部远程服务器上传数据。
临时共享密钥令牌：每次会话自动生成受 0600 系统文件权限保护的 256 位令牌 (.noust-bridge.token)。
输入净化：AI 代理生成的任何富文本内容在渲染到画布前均经由 DOMPurify 净化，杜绝 XSS 注入风险。
加密工作区：如果 .noust 文件已使用用户密码加密，MCP 服务器仅在 Noust 在浏览器中打开并处于活动状态时工作。通过这种机制，AI 代理无法直接从磁盘读取 .noust 内容，只能且必须通过 MCP 服务器的官方工具进行交互。

技术文档与源代码

开发者命令行参数 (-d / -r) 及完整工具 Schema 定义请参见官方开源仓库：

🔗 GitHub: noust-app/mcp

模型上下文协议 (MCP) ​

AI 可以在您的工作区中做什么？ ​

双模架构 (在线与离线) ​

多工作区与跨标签页路由 ​

标准 MCP 资源 (Resources) ​

资源自动发现与双模连续性 ​

快速配置指南 ​

前提条件 ​

1. Claude Desktop ​

2. Cursor IDE ​

安全与隐私保护 (零知识架构) ​

技术文档与源代码 ​