AI导哈

Tana本地API连接工具

连接Codex与Tana桌面本地API/MCP，实现对节点、标签和字段的安全读写操作。

  • by MYC3
  • Shell
  • 本地部署
  • 更新于
在 GitHub 查看 MYC3/tana-local-mcp

使用说明

塔纳当地MCP

英语 | 简体中文

将Codex连接到Tana Desktop本地API/MCP，以实现节点、标签和字段上的安全读/写工作流。

这项技能有什么作用

  • 指南设置 tana-local MCP(add + login)
  • 验证与本地健康检查脚本的连接
  • 建议先阅读工作流(list_tags, search_nodes, read_node)
  • 涵盖写入工作流程(edit_node, set_field_content, tag等等）

可用工具

阅读

  • list_workspaces --列出可用工作区
  • search_nodes --使用结构化查询进行搜索
  • read_node --将节点内容作为标记读取
  • get_children --获取节点的分页子节点
  • list_tags --列出工作区中的标签
  • get_tag_schema --获取标记的字段定义

突变

  • import_tana_paste --导入分层内容
  • tag --在节点中添加/删除标签
  • set_field_option --设置下拉字段值
  • set_field_content --设置文本/数字/日期字段值
  • create_tag --创建新标签
  • add_field_to_tag --向标签添加字段
  • set_tag_checkbox --配置复选框行为
  • check_node / uncheck_node --标记节点已完成/未完成
  • trash_node --将节点移动到回收站
  • get_or_create_calendar_node --获取/创建日历节点
  • edit_node --使用搜索和替换编辑节点的名称和/或描述

安装

  1. 将技能文件夹复制到Codex技能目录中，例如：
cp -R skills/tana "$CODEX_HOME/skills/tana"
  1. 在项目中添加技能条目 AGENTS.md （名称、描述、文件路径）。

通过技能安装程序（GitHub）安装

如果您使用内置 skill-installer，直接从此仓库安装：

# Example: install from GitHub repo path
# Use the skill-installer workflow in Codex and provide:
<owner>/tana-local-mcp + path `skills/tana`

先决条件

  1. Tana桌面正在运行
  2. Local API/MCP server (Alpha) 在Tana Labs中启用
  3. MCP服务器已配置：
codex mcp add tana-local --url http://localhost:8262/mcp
  1. OAuth登录已完成：
codex mcp login tana-local

快速检查

scripts/check_tana_local_api.sh

预期：JSON格式 "status":"ok".

默认保存行为

  • 当用户要求将内容保存到Tana或通过Tana记录笔记时，默认为工作区的每日笔记日节点：call get_or_create_calendar_node (granularity: "day")并通过写入 import_tana_paste 到那个节点。
  • 仅当用户明确指定具体目录和标记时，才覆盖此默认值。

在提示中使用

  • 使用 / 从技能面板中选择Tana本地MCP命令以执行Tana操作。
  • 如果 /Tana Local MCP 未在新线程中显示，请使用 $Tana Local MCP <content> 明确地。

存储库布局

  • skills/tana/SKILL.md
  • skills/tana/agents/openai.yaml
  • skills/tana/references/tana-local-mcp-ops.md
  • skills/tana/scripts/check_tana_local_api.sh

许可证

麻省理工学院

相关 MCP