Tana MCP Server

一个连接到Tana 输入API的模型上下文协议（MCP）服务器，允许大型语言模型（LLMs）和其他MCP客户端在Tana工作空间中创建和操作数据。

<a href="https://glama.ai/mcp/servers/r6v3135zsm"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=2646607172,3796315652&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Tana Server MCP服务器" /> </a>

功能

此MCP服务器提供了对Tana输入API的全面访问：

🛠 工具（11个可用）

• 节点创建：创建普通、引用、日期、URL、复选框和文件节点
• 字段管理：创建和管理带有结构化数据的字段节点
• 复杂结构：构建嵌套节点层次结构
• 模式操作：创建超级标签和字段定义
• 节点更新：修改现有节点名称

💬 提示（4个模板）

• 任务创建：带截止日期和优先级的结构化任务创建
• 项目设置：带有目标和里程碑的完整项目结构
• 会议记录：带有参会人员和行动项的格式化会议记录
• 知识库：带有类别和来源的组织知识条目

📚 资源（4个可用）

• API文档：Tana输入API的完整参考
• 节点类型指南：所有支持的节点类型的详细示例
• 使用示例：常见模式和最佳实践
• 服务器信息：当前状态和配置详情

需求

• Node.js 18或更高版本
• 具有API访问权限的Tana工作空间
• Tana API令牌（从Tana设置生成）

安装

全局安装（推荐）

npm install -g tana-mcp

局部安装

npm install tana-mcp

配置

Claude Desktop

在你的Claude Desktop配置文件中添加以下内容：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json
Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "tana-mcp": {
      "command": "npx",
      "args": ["-y", "tana-mcp"],
      "env": {
        "TANA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Raycast

1. 在Raycast中安装MCP扩展
2. 打开“管理MCP服务器”命令
3. 添加具有以下配置的新服务器：

{
  "tana-mcp": {
    "command": "npx",
    "args": ["-y", "tana-mcp"],
    "env": {
      "TANA_API_TOKEN": "your-api-token-here"
    }
  }
}

其他MCP客户端

对于其他兼容MCP的客户端，请使用：

• 命令：npx -y tana-mcp（如果全局安装则使用tana-mcp）
• 环境：TANA_API_TOKEN=your-api-token-here

获取您的Tana API令牌

1. 在浏览器中打开Tana
2. 前往设置→API令牌
3. 创建一个具有适当权限的新令牌
4. 复制该令牌并将其添加到您的MCP客户端配置中

使用示例

配置完成后，您可以通过您的MCP客户端与Tana进行交互：

创建简单节点

在我的Tana工作空间中创建一个名为“项目想法”的新节点

创建任务

创建一个任务“审查Q4预算”，高优先级，定于下周五到期

创建项目结构

创建一个名为“网站重新设计”的项目，带有设计、开发和发布里程碑

使用提示

支持提示的MCP客户端可以使用如下模板：

• create-task - 交互式任务创建
• create-project - 结构化项目设置
• create-meeting-notes - 会议文档
• create-knowledge-entry - 知识库条目

API限制

• 每次请求最多100个节点
• 速率限制：每秒每个令牌1个请求
• 负载大小：最大5000字符
• 工作空间限制：750,000个节点

开发

从源代码构建

git clone https://github.com/tim-mcdonnell/tana-mcp.git
cd tana-mcp
npm install
npm run build

开发运行

TANA_API_TOKEN=your-token npm run dev

故障排除

“缺少预期参数键：items”（Raycast）

此错误已在v1.2.0中修复。请更新到最新版本。

连接问题

• 验证您的API令牌是否正确
• 检查您的工作空间是否未超过750,000个节点的限制
• 确保您没有超出速率限制（每秒1个请求）

节点创建失败

• 验证目标节点ID是否存在（如果指定了）
• 检查超级标签/字段ID是否有效
• 确保负载不超过5000字符

贡献

欢迎贡献！请随时提交Pull Request。

许可

MIT许可 - 详情见LICENSE文件。

支持

对于问题和功能请求，请使用GitHub Issues页面。