墨问笔记 MCP 服务器

What is 墨问笔记 MCP 服务器?

墨问笔记 MCP 服务器是一个基于模型上下文协议（MCP）的服务器，用于与墨问笔记软件进行交互。它允许用户在支持 MCP 的应用（如 Cursor、Claude Desktop 等）中直接创建、编辑和管理墨问笔记。本项目由一支烟花社区和墨问合作共创。

How to use 墨问笔记 MCP 服务器?

安装方式包括从源码安装（git clone 后 pip install -e .）或直接安装依赖（pip install mcp httpx pydantic）。配置 API 密钥可通过环境变量（MOWEN_API_KEY）或 .env 文件。在 MCP 客户端（如 Cursor）的配置文件中添加类似 "command": "python", "args": ["-m", "mowen_mcp_server.server"] 的配置，并设置 env 中的 MOWEN_API_KEY。此外还有免安装版：下载 Windows 下的 mowen-mcp-server.exe 并指定路径。

Key features of 墨问笔记 MCP 服务器

• 兼容 MCP 1.9.1 协议
• 创建、编辑笔记，支持富文本格式
• 文件上传：图片、音频、PDF（本地或 URL）
• 引用段落和内链笔记
• 隐私设置与 API 密钥重置
• 统一接口，所有笔记操作使用一致参数

Use cases of 墨问笔记 MCP 服务器

• 在 AI 聊天工具内直接创建带有格式化文本的墨问笔记
• 通过 MCP 客户端自动整理会议记录并插入图片/音频附件
• 批量编辑已有笔记内容，实现内容更新
• 引用其他笔记，建立知识关联网络
• 设置笔记的公开或私有权限，管理笔记可见性

FAQ from 墨问笔记 MCP 服务器

Q: API密钥在哪里获取？

API 密钥在墨问小程序个人主页的开发者模块中获取，需要 Pro 会员权限。

Q: 能编辑小程序创建的笔记吗？

目前不支持，只能编辑通过 API 创建的笔记。

Q: 文件上传时为什么提示"文件不存在"？

必须使用绝对路径，因为 MCP Server 和 Client 运行在不同的工作目录。例如 Windows: "C:\\Users\\用户名\\Documents\\image.jpg"。

Q: 支持哪些文件类型？

支持图片（gif/jpeg/jpg/png/webp，最大50MB）、音频（mp3/mp4/m4a，最大200MB）和 PDF（最大100MB）。

Q: 内链笔记的note_id从哪里获取？

note_id 是创建笔记时返回的笔记ID，或墨问中已存在笔记的ID，注意只能引用通过API创建的笔记。