AI导哈

Tana MCP服务器

tana-mcp-codemode 是一个 MCP 服务器，让 AI 能够编写 TypeScript 代码直接操作 Tana 本地 API，用于节点搜索、导入、编辑及标签字段管理，适用于构建自动化知识管理工作流。

  • by fabiogaliano
  • TypeScript
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 fabiogaliano/tana-mcp-codemode

使用说明

tana-mcp-codemode

Codemode MCP server for Tana. AI writes TypeScript that executes directly against the Tana Local API.

Requires: Tana Desktop with Local API enabled + an API token (Settings → API).

Install

Binary — download from GitHub Releases, chmod +x, run.

npm (Node.js ≥ 20):

npm install -g tana-mcp-codemode

From source (Bun): git clone → bun install → bun run src/entry-bun.ts

Setup

Run the interactive setup script — detects your installation, prompts for credentials, and configures Claude Code and/or Claude Desktop automatically:

bun run setup
# or for team-shared config:
bun run setup --scope project

Manual MCP Configuration

{
  "mcpServers": {
    "tana": {
      "command": "tana-mcp-codemode",
      "env": {
        "TANA_API_TOKEN": "your-token-here",
        "MAIN_TANA_WORKSPACE": "My Workspace"
      }
    }
  }
}

For binary: set command to the binary path. For source: "command": "bun", "args": ["run", "/path/to/src/entry-bun.ts"].

Environment Variables

Variable Default Description
TANA_API_TOKEN required Bearer token from Tana Desktop
TANA_API_URL http://127.0.0.1:8262 Tana Local API URL
MAIN_TANA_WORKSPACE — Default workspace name or ID
TANA_SEARCH_WORKSPACES — Comma-separated workspaces for search scope
TANA_TIMEOUT 10000 Request timeout in ms
TANA_HISTORY_PATH platform default Custom SQLite history path

Usage Examples

// Search nodes
const results = await tana.nodes.search("project ideas", {
  workspaceIds: [tana.workspace.id]
});

// Import with tags and fields
await tana.import(tana.workspace.id, `
%%tana%%
- Meeting notes #meeting
  - Date:: [[2024-01-15]]
  - Attendees:: Alice, Bob
`);

API Reference

Namespace Methods
tana.workspace pre-resolved default workspace
tana.workspaces list()
tana.nodes search(), read(), getChildren(), edit(), move(), trash(), check(), uncheck(), open()
tana.tags listAll(), getSchema(), getParents(), create(), modify(), addField(), setCheckbox()
tana.fields setOption(), setContent(), getFieldOptions()
tana.calendar getOrCreate()
tana.import() import Tana Paste content
tana.health() API health check

Development

bun run start        # MCP server
bun run dev          # watch mode
bun run test         # tests
bun run build        # Node.js dist (tsup)
bun run build:binary # self-contained binary
bun run debug        # debug UI at :3333

License

MIT

相关 MCP