Tana MCP Server

MCPAI代理

提供方 tim-mcdonnell

AI代理 stdio · 本地进程 Token 社区 / 第三方 Claude DesktopClaude

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

一句话选型结论

按资料字段整理

Tana MCP Server 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式支持远程部署
GitHub 星标 35 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

TanaAPITypeScript本地部署模型上下文协议数据操作LLM集成工作区管理

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tana MCP Server当前 未标注 stdio · 本地进程 支持远程部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方tim-mcdonnell上游标注的维护方 tim-mcdonnell
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

4.1 KB
来自项目仓库与上游目录的原文,未做删改

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设置生成)

安装

全局安装(推荐)```bash

npm install -g tana-mcp


### 本地安装```bash
npm install tana-mcp

配置

克劳德桌面

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

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json\
视窗: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"tana-mcp": {
"command": "npx",
"args": ["-y", "tana-mcp"],
"env": {
"TANA_API_TOKEN": "your-api-token-here"
}
}
}
}


### 光线投射

1. 在Raycast中安装MCP扩展
1. 打开“管理MCP服务器”命令
1. 使用此配置添加新服务器:```json
{
"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个节点

## 发展

### 从源头构建```bash
git clone https://github.com/tim-mcdonnell/tana-mcp.git
cd tana-mcp
npm install
npm run build

在发展中奔跑```bash

TANA_API_TOKEN=your-token npm run dev
```

故障排除

“缺少预期的参数键:items”(Raycast)

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

连接问题

  • 验证您的API令牌是否正确
  • 检查您的工作区是否未超过750k节点限制
  • 确保您没有超过速率限制(1个请求/秒)

节点创建失败

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

贡献

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

许可证

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

支持

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

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Tana MCP Server 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Tana MCP Server 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Tana MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Tana MCP Server 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Tana MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Tana MCP Server 能提供哪些能力?

资料显示能力标签包括 工作区管理、TypeScript、Claude、数据操作。具体工具清单以官方文档为准。

Tana MCP Server 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

Tana MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。