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"
}
}
}
}光线投射
- 在Raycast中安装MCP扩展
- 打开“管理MCP服务器”命令
- 使用此配置添加新服务器：
{
"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代币
- 在浏览器中打开Tana
- 转到“设置”→ API令牌
- 创建具有适当权限的新令牌
- 复制令牌并将其添加到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许可证-有关详细信息，请参阅许可证文件
支持
有关问题和功能请求，请使用 页面。