Tano 的本地 stdio MCP 服务让 Agent 列举、读取、创建和条件写入桌面工作区中的 Markdown 文档。
连接本地工作区
先在桌面端打开工作区，再使用桌面 MCP 面板提供的启动命令和路径配置你的 MCP 客户端。服务需要 Node.js 24.12 或更新版本。
工作区路径指向你的 Markdown 文件夹。应用数据路径必须位于工作区外，并与桌面应用使用同一目录，以便共享本地活动记录。
从开源项目源码运行服务时，可在项目根目录执行：
npm run mcp:build
node apps/mcp/dist/tano-mcp.cjs --workspace /path/to/notes --data-dir /path/to/tano-app-data
文档工具
| 工具 | 用途 |
|---|---|
tano_list_documents |
列举选定工作区中的 Markdown 路径 |
tano_read_document |
读取文档内容及其 SHA-256 哈希 |
tano_create_document |
创建新文档，已有文件不会被覆盖 |
tano_write_document |
使用 expectedHash 条件写入已有文档 |
更新前先读取文档，将返回的 sha256 作为写入参数 expectedHash。如果文件已发生变化，写入会被拒绝；重新读取并审阅、合并变化后再提交。
接入边界
服务操作选定工作区内的 Markdown 文件，不执行远程命令，也不提供实时网络协作。客户端提交的名称只是活动标签，不代表已验证的身份。
文档内容和工具结果仍是工作区数据。Agent 应将你的工作区指引与文档内容区分开，并在你的授权范围内操作。
继续阅读与 Agent 一起工作和文件访问与写入。源码与接入说明见开源项目。