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服务器。