关于 NoteFlow-MCP
NoteFlow-MCP 是连接笔记类 API 的 FastMCP v2 服务,提供创建和列出笔记的工具。默认的 DummyJSON 后端仅模拟写入,不会持久保存笔记。
主要功能
- 01按标题和内容创建笔记
- 02从 API 列出笔记
- 03配置笔记 API 后端
适用场景
- 01通过 MCP 客户端创建笔记
- 02查看配置 API 中的笔记
MCP 相关
它向 MCP 客户端提供 `create_note` 和 `list_notes` 工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://2c08-27-4-120-4.ngrok-free.app/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http surendhar-23-noteflow https://2c08-27-4-120-4.ngrok-free.app/mcpCursor.cursor/mcp.json
{"mcpServers":{"surendhar-23-noteflow":{"type":"http","url":"https://2c08-27-4-120-4.ngrok-free.app/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"surendhar-23-noteflow":{"type":"http","url":"https://2c08-27-4-120-4.ngrok-free.app/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"surendhar-23-noteflow":{"type":"http","url":"https://2c08-27-4-120-4.ngrok-free.app/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"surendhar-23-noteflow":{"serverUrl":"https://2c08-27-4-120-4.ngrok-free.app/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
noteflow-mcp
noteflow-mcp 是一个连接笔记类 API 的 FastMCP v2 服务。
设置
安装依赖:
uv sync
创建环境文件:
cp .env.example .env
然后用真实的笔记 API 设置更新 .env。
当前默认使用 DummyJSON 的免费帖子 API 作为笔记后端:
GET https://dummyjson.com/postsPOST https://dummyjson.com/posts/add
DummyJSON 不需要 API 密钥,因此 NOTES_API_KEY 可以留空。
在本地运行
uv run noteflow-mcp
或者:
uv run python -m noteflow_mcp.server
已公开的工具
create_note(title, content)list_notes()
create_note 会将笔记内容映射到 DummyJSON 的 body 字段。DummyJSON 会模拟写入以供测试,因此创建的笔记不会在服务端持久保存。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。