Tana MCP Server

Tana MCP服务器

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

特性

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

🛠️ 工具（11个可用）

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

💬 提示（4个模板）

• 任务创建：创建具有截止日期和优先级的结构化任务
• 项目设置：完整的项目结构，包括目标和里程碑
• 会议笔记：包含与会者和行动项目的格式化会议记录
• 知识库：按类别和来源组织知识条目

📚 资源（4个可用）

• API文档：Tana Input API的完整参考
• 节点类型指南：所有支持的节点类型的详细示例
• 使用示例：常见模式和最佳做法
• 察看连接信息：当前状态和配置详细信息

需求

• Node.js 18或更高版本
• 启用API访问的Tana工作区
• Tana API令牌（根据Tana设置生成）

安装

全局安装（推荐）

npm install -g tana-mcp

本地安装

npm install tana-mcp

配置

克劳德桌面

将此添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\ 视窗: %APPDATA%\Claude\claude_desktop_config.json

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

光线投射

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交互：

创建一个简单节点

Create a new node titled "Project Ideas" in my Tana workspace

创建任务

Create a task "Review Q4 budget" with high priority due next Friday

创建项目结构

Create a project called "Website Redesign" with milestones for design, development, and launch

使用提示

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

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

API限制

• 每个请求最多100个节点
• 速率限制：每个令牌每秒1个请求
• 有效载荷大小：最多5000个字符
• 工作空间限制：750000个节点

发展

从源头构建

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令牌是否正确
• 检查您的工作区是否未超过750k节点限制
• 确保您没有超过速率限制（1个请求/秒）

节点创建失败

• 验证目标节点ID是否存在（如果指定）
• 检查超级标签/字段ID是否对您的工作区有效
• 确保有效载荷少于5000个字符

贡献

欢迎投稿！请随时提交拉取请求。

许可证

MIT许可证-有关详细信息，请参阅许可证文件

支持

有关问题和功能请求，请使用 页面。