关于 xNotepad AI
xNotepad AI 是为 AI Agent 提供持久化加密笔记的 MCP 服务,支持搜索和问答。它还可整理和关联笔记,并将 Agent 的修改限制在其创建的笔记上。
主要功能
- 01创建、读取和更新笔记
- 02语义搜索笔记
- 03针对笔记内容提问
- 04为笔记添加标签、链接、合并和归档
- 05查看笔记版本历史
适用场景
- 01在 Agent 会话之间保存研究资料和决策
- 02用自然语言查询以找回既有决策
- 03通过标签和维基链接整理笔记
- 04在多个 Agent 间共享笔记记忆
MCP 相关
它通过 Streamable HTTP JSON-RPC 在 `https://www.xnotepadai.com/api/mcp/` 提供 13 种笔记管理和检索工具,并使用 Bearer token 认证。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://www.xnotepadai.com/api/mcp/一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http com-xnotepadai-notes https://www.xnotepadai.com/api/mcp/Cursor.cursor/mcp.json
{"mcpServers":{"com-xnotepadai-notes":{"type":"http","url":"https://www.xnotepadai.com/api/mcp/"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"com-xnotepadai-notes":{"type":"http","url":"https://www.xnotepadai.com/api/mcp/"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"com-xnotepadai-notes":{"type":"http","url":"https://www.xnotepadai.com/api/mcp/"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"com-xnotepadai-notes":{"serverUrl":"https://www.xnotepadai.com/api/mcp/"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
https://www.xnotepadai.com/api/mcp/需要授权工具
详细介绍
xNotePadAI — MCP 服务
一个包含 13 个工具的 MCP 服务,通过笔记为 AI Agent 提供持久、加密且可搜索的记忆。
端点: https://www.xnotepadai.com/api/mcp/
协议: 基于 Streamable HTTP 的 MCP(Model Context Protocol)JSON-RPC
身份验证: Bearer 令牌
免费套餐: 每月 1,000 次调用
快速开始
{
"mcpServers": {
"xnotepad": {
"type": "http",
"url": "https://www.xnotepadai.com/api/mcp/",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
获取令牌:https://www.xnotepadai.com/settings/ → Your MCP Token(已预先生成,可直接复制)
工具
| 工具 | 描述 |
|---|---|
create_note | 创建笔记(自动添加 agent-created 标签) |
list_notes | 列出所有笔记及其标题、大小和日期 |
get_note | 根据 ID 获取笔记的完整内容 |
update_note | 更新内容(仅限 Agent 创建的笔记) |
delete_note | 删除笔记(仅限 Agent 创建的笔记) |
search_notes | 通过向量嵌入进行语义搜索 |
ask_notes | 提出问题 — AI 根据笔记内容作答 |
get_versions | 获取笔记的版本历史 |
tag_note | 为笔记添加标签 |
link_notes | 在笔记之间添加 [[wiki-links]] |
merge_notes | 合并两篇笔记(之后删除源笔记) |
archive_note | 归档笔记 |
index_notes | 将笔记向量化,以便进行语义搜索 |
安全模型
- Bearer 令牌身份验证 — 使用 SHA-256 哈希处理后存储在 D1 中,可撤销
- 租户隔离 — 租户 ID 根据令牌查询结果确定,绝不取自客户端参数
- Agent 沙箱 — Agent 只能修改或删除带有
agent-created标签的笔记 - 速率限制 — 每个 IP 每分钟 30 次请求
- 零知识加密 — 笔记在客户端使用 AES-256-GCM 加密(MCP 访问用户同步的未加密副本)
使用场景
- AI 记忆 — Agent 在不同会话之间保存研究内容、决策和架构笔记
- 知识检索 — “我对身份验证做了什么决定?”→ 搜索你的笔记
- 笔记自动化 — 自动添加标签、自动建立链接、合并重复笔记、归档旧笔记
- 多 Agent 工作流 — 一个 Agent 写入,另一个稍后读取
技术栈
- Cloudflare Workers(运行时)
- Cloudflare D1(数据库)
- Cloudflare Vectorize(语义搜索)
- Workers AI / Llama 3.3 70B(AI 回答)
文档
- MCP 集成:https://www.xnotepadai.com/mcp/
- API 参考:https://www.xnotepadai.com/developers/
- 隐私:https://www.xnotepadai.com/privacy/
许可证
MIT
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。