Tiddly MCP

TiddlyWiki的MCP插件，允許AI代理連接並操作TiddlyWiki知識庫，提供讀取、搜索、寫入和刪除條目等工具。

知識管理與記憶筆記工具 #TiddlyWiki插件 #AI代理連接 #知識庫操作 #MCP協議 .TypeScript

評分 : 2.5分

下載量 : 6.7K

更新時間 : 2026-03-13

打開站點

什麼是 Tiddly MCP?

Tiddly MCP 是一個橋樑插件，它遵循 Model Context Protocol (MCP) 標準，將你的 TiddlyWiki 知識庫暴露給 AI 助手（如 Claude、Gemini 等）。這意味著 AI 可以像人類用戶一樣，在你的 Wiki 中查找信息、創建或更新條目，從而幫助你更高效地整理和利用知識。

如何使用 Tiddly MCP?

首先，你需要在 Node.js 服務器上運行的 TiddlyWiki 中安裝此插件。安裝並配置後，插件會啟動一個 MCP 服務器。然後，你可以在支持 MCP 的 AI 客戶端（如 Claude Desktop、Gemini CLI）中配置連接到此服務器。連接成功後，AI 助手就能使用提供的工具來操作你的 Wiki 了。

適用場景

當你需要 AI 助手基於你的個人或團隊知識庫（存儲在 TiddlyWiki 中）來回答問題、總結內容或協助創作時，Tiddly MCP 就非常有用。例如，讓 AI 幫你整理會議筆記、查找項目相關資料，或者基於現有條目生成新的內容草稿。

主要功能

列出條目 (Tiddlers)

AI 可以獲取 Wiki 中所有條目的列表，或者使用強大的過濾器表達式來篩選出特定條目。

讀取條目內容

AI 可以通過標題精確讀取任何一個條目的詳細內容，包括文本、標籤等元數據。

全文搜索

AI 可以在整個 Wiki 或特定字段中進行關鍵詞搜索，快速定位相關信息。

創建與更新條目

AI 可以創建新條目或修改現有條目。此功能默認關閉，需手動開啟以確保安全。

刪除條目

AI 可以刪除指定條目。此功能同樣默認關閉，需要謹慎配置後使用。

優勢

無縫集成：將強大的 AI 能力引入你熟悉的 TiddlyWiki 工作流。

操作靈活：提供從只讀到讀寫的多種工具，權限可控。

廣泛兼容：已測試支持 Claude、Gemini、Simtheory 等多個主流 AI 平臺。

聚焦知識：讓 AI 的回覆基於你的個人知識庫，更具相關性和準確性。

侷限性

僅限服務器版：僅適用於 Node.js 託管的 TiddlyWiki，不適用於單文件版。

安全考量：寫入和刪除功能需謹慎配置，暴露到公網存在風險。

開發中狀態：插件仍在完善中，功能可能發生變化。

需要技術基礎：安裝和配置需要一定的服務器操作知識。

如何使用

安裝插件

在你的 Node.js 版 TiddlyWiki 中，通過拖放插件 JSON 文件或複製插件文件夾到插件目錄的方式來安裝 Tiddly MCP。

配置插件

打開插件控制面板，配置 MCP 服務器運行的端口（例如 3000）和其他設置。最重要的是，根據需求決定是否啟用‘寫入’和‘刪除’工具。

重啟服務器

保存配置後，重啟你的 TiddlyWiki 服務器。檢查日誌中是否出現類似 ‘[MCP] TiddlyWiki MCP Server started on port 3000’ 的消息，確認服務器已成功啟動。

配置 AI 客戶端

在你使用的 AI 客戶端（如 Claude Desktop）中，添加一個新的 MCP 服務器配置。服務器地址通常為 `http://localhost:你配置的端口`（例如 `http://localhost:3000`）。如果配置了認證，需要添加相應的請求頭。

使用案例

研究助理：查找相關資料

你正在撰寫一篇關於“機器學習”的報告，可以讓 AI 助手在你的 Wiki 中查找所有相關的筆記和參考資料。

內容整理：自動生成摘要

你有一系列零散的每日工作日誌，想讓 AI 幫你整理成本週的總結。

知識擴展：基於現有筆記創作

你有一些關於“項目管理方法論”的零散筆記，想讓 AI 幫你整合並起草一份完整的介紹文檔。

常見問題

我使用的是單機版（單 HTML 文件）的 TiddlyWiki，可以用這個插件嗎？

啟用寫入/刪除功能安全嗎？

AI 助手如何使用 TiddlyWiki 的“過濾器”(Filter)？

為什麼 AI 客戶端連接不上我的 MCP 服務器？

這個插件是官方的嗎？

🚀 Tiddly MCP

Tiddly MCP是一個適用於 TiddlyWiki 的模型上下文協議（Model Context Protocol）插件，它能讓你將AI代理連接到你的TiddlyWiki。

警告： 此插件仍在開發中。

該插件已通過以下工具的測試並能正常工作：

該插件僅支持服務器（由Node.js託管）版本的TiddlyWiki。

此插件通過MCP為AI代理提供以下工具：

名稱	描述	參數
`list_tiddlers`	列出所有條目，或使用過濾表達式對其進行過濾。	`filter`、`limit`、`includeSystem`、`includeDetails`
`read_tiddler`	按標題讀取一個條目。	`title`
`search_tiddlers`	搜索包含特定文本的條目。	`query`、`field`、`caseSensitive`
`write_tiddler`	按標題創建或更新一個條目。	`title`、`text`、`tags`、`type`、`username`
`delete_tiddler`	按標題刪除一個條目。	`title`

該插件默認處於只讀模式。更新和刪除條目的工具默認是關閉的。

🚀 快速開始

Tiddly MCP插件能助力你把AI代理與TiddlyWiki相連接，以下為你介紹其使用方式。

✨ 主要特性

支持多種AI工具，如Gemini CLI、Claude Code、Claude和Simtheory。
為AI代理提供了一系列操作TiddlyWiki條目的工具，包括列出、讀取、搜索、寫入和刪除條目。
默認處於只讀模式，保障數據安全性。

📦 安裝指南

此插件僅適用於服務器（由Node.js託管）版本的TiddlyWiki。

將 $__plugins_rryan_tiddly-mcp.json 拖放到你的 由Node.js託管的 TiddlyWiki中並導入該條目，或者將 tiddly-mcp 文件夾複製到你的TiddlyWiki插件路徑中。
打開插件配置，自定義端口和其他設置。
重啟服務器，並確認在日誌中看到 [MCP] TiddlyWiki MCP Server started on port XXXX。

⚠️ 重要提示

⚠️ 重要提示

目前，我們建議不要將此MCP服務器暴露在互聯網上。你可以在本地將該插件與Gemini CLI、Claude Code或Claude Desktop配合使用，這樣不會有任何安全風險。

如果你確實要將該插件暴露在互聯網上，我們建議：

像搭建Node.js託管的TiddlyWiki一樣，將其設置在反向代理之後。

使用HTTP基本身份驗證來保護訪問。大多數客戶端支持自定義標頭，你可以通過它提供 Authentication: Basic asdf1234 身份驗證標頭。

將CORS允許的主機設置為你託管它的域名。

使用 https://example.com/mcp 以外的路徑，以避免攻擊者掃描MCP服務器。