/ 目錄 / 演練場 / anytype-mcp
● 社群 anyproto ⚡ 即開即用

anytype-mcp

作者 anyproto · anyproto/anytype-mcp

官方 Anytype MCP — 從任何 AI 助理搜尋並管理你的加密本地知識庫(物件、清單、類型、屬性)。

anytype-mcp (anyproto) 是 Anytype 團隊發布的官方伺服器。透過你在 App Settings 中產生的 bearer token 與本地 Anytype API(預設 127.0.0.1:31009)溝通。適合重視隱私、希望以 AI 代理控制知識庫的使用者。

為什麼要用

核心特性

即時演示

實際使用效果

anytype.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "anytype-mcp"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "anytype-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "anytype-mcp"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "anytype-mcp"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "anytype",
      "command": "npx",
      "args": [
        "-y",
        "anytype-mcp"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "anytype": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "anytype-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add anytype -- npx -y anytype-mcp

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: anytype-mcp

將代理研究成果擷取至 Anytype 物件

👤 研究人員、個人知識管理愛好者 ⏱ ~15 min beginner

何時使用: 你希望 Claude 對話中的重點摘要直接進入你的知識庫,而不是消失在另一個聊天記錄裡。

前置條件
  • Anytype 桌面版正在執行 — anytype.io
  • API 金鑰 — Anytype → App Settings → API Keys → New
步驟
  1. 定義目標類型
    In my Anytype space 'Research', ensure a type 'Paper Note' exists with properties [title, summary, source, tags].✓ 已複製
    → 類型已建立或已存在
  2. 從對話內容建立物件
    For each paper I referenced in the last turn, create a 'Paper Note' object with summary and tags.✓ 已複製
    → N 個物件已建立

結果: 對話中產出的知識會被保存到你日後找得到的地方。

注意事項
  • Bearer token 洩漏至日誌 — 使用環境變數,切勿直接寫入程式碼;若已外洩請立即重新產生
搭配使用: zotero

將 Anytype 收件匣空間整理為有類型的筆記

👤 個人知識管理維護者 ⏱ ~25 min intermediate

何時使用: 你的「收件匣」空間不斷堆積,希望 AI 自動分類並歸檔至正確的類型。

步驟
  1. 列出收件匣項目
    Search objects in space 'Inbox' with no type or type='Note'. Return titles + snippet.✓ 已複製
    → 原始收件匣清單
  2. 分類並重新設定類型
    For each, propose the right type (Idea, Task, Reference, Person) and move it to the correct space. Apply tags.✓ 已複製
    → 收件匣內容被整理至結構化空間

結果: 個人知識庫持續自動整理,無需手動分類。

用 Anytype MCP 向自己的知識庫提問

👤 累積多年筆記的使用者 ⏱ ~10 min beginner

何時使用: 你記得曾經寫過某個相關內容,但就是找不到。

步驟
  1. 全域搜尋
    Search all my Anytype spaces for notes mentioning 'retrieval augmentation'. Return top 10 with snippets.✓ 已複製
    → 跨空間的排序搜尋結果
  2. 統整摘要
    Summarize what past me thought about this topic, with links back to the objects.✓ 已複製
    → 附有引用來源的個人知識回顧

結果: 不再遺失自己曾有的思考與洞見。

組合

與其他 MCP 搭配,撬動十倍槓桿

anytype + zotero

論文 PDF 保留在 Zotero;閱讀筆記與綜合摘要存放於 Anytype

For papers tagged 'to-read' in Zotero, create corresponding Anytype Paper Notes with the abstract as starter content.✓ 已複製
anytype + firecrawl

爬取網頁 → 摘要整理 → 儲存至 Anytype

Scrape anthropic.com/news from the last month, summarize each post, and create an Anytype object per post.✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
global_search query: str, limit? 跨空間查詢 0
space_search space, query 限定範圍搜尋 0
create_object space, type, properties 新增筆記或記錄 0
update_object object_id, properties 編輯現有物件 0
list_types space? 探索資料結構綱要 0
list_members space 多使用者空間管理 0

成本與限制

運行它的成本

API 配額
無 — 使用本地 Anytype
每次呼叫 Token 數
若筆記內容龐大,完整物件讀取可能佔用大量 token
費用
免費
提示
建立物件前優先呼叫 list_types/list_properties;避免代理自行產生類型造成綱要混亂

安全

權限、密鑰、影響範圍

憑證儲存: 將 Anytype 的 bearer token 存放於環境變數;在 App Settings 中定期更換
資料出站: 預設僅連線至 127.0.0.1:31009;Anytype 本身同步時使用端對端加密

故障排查

常見錯誤與修復

Connection refused

Anytype 桌面版必須正在執行;確認 App Settings 中已啟用 API,且連接埠 31009 未被封鎖

驗證: curl http://127.0.0.1:31009/health
401 Unauthorized

Token 已被撤銷或有誤;請至 App Settings → API Keys 重新產生

Objects created in the wrong space

請務必明確傳入 space 參數;系統沒有「預設空間」的安全機制

替代方案

anytype-mcp 對比其他方案

替代方案何時用它替代權衡
Notion MCP你主要使用 Notion;優先考量協作與雲端存取非本地優先;僅支援雲端託管
Obsidian MCP你偏好以 Markdown 資料夾為主的筆記模式資料模型不同(以檔案為主,而非物件)

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills