墨问笔记 MCP 服务器

这是一个基于**模型上下文协议（MCP）**的服务器，用于与墨问笔记软件进行交互。通过此服务器，你可以在支持MCP的应用（如Cursor、Claude Desktop等）中直接创建、编辑和管理墨问笔记。

本项目由一支烟花社区和墨问合作共创。

🆕 免安装版上线了（小白可用）

使用方法（windows为例）

1. 下载mowen-mcp-server-windows-x64-v1.0.0.zip并解压出mowen-mcp-server.exe
2. mcp客户端中修改command值，替换成mowen-mcp-server.exe文件的路径即可

{
  "mcpServers": {
    "mowen-mcp-server": {
      "command": "D:\\mowen\\mowen-mcp-server.exe",
      "args": [],
      "env": {
        "MOWEN_API_KEY": "xxxxxxxxxxxxxxx"
      }
    }
  }
}

✨ 最新版本特性：支持文件上传功能！现在可以在笔记中插入图片、音频和PDF文件，支持本地文件和远程URL两种上传方式。

🆕 新功能预览 (v0.2.0)

📁 文件上传支持

⚠️ 重要：文件路径必须使用绝对路径，因为MCP Server和Client运行在不同的工作目录中。

# 本地图片文件
{
    "type": "file",
    "file_type": "image",
    "source_type": "local",
    "source_path": "C:\\Users\\用户名\\Documents\\image.jpg",  # Windows绝对路径
    "metadata": {
        "alt": "图片描述",
        "align": "center"
    }
}

# 远程音频文件（URL不受路径限制）
{
    "type": "file",
    "file_type": "audio",
    "source_type": "url",
    "source_path": "https://example.com/audio.mp3",
    "metadata": {
        "show_note": "00:00 开始\n01:30 主要内容"
    }
}

📝 引用段落

{
    "type": "quote",
    "texts": [
        {"text": "重要提醒：", "bold": true},
        {"text": "支持富文本格式的引用段落"}
    ]
}

🔗 内链笔记

{
    "type": "note",
    "note_id": "VPrWsE_-P0qwrFUOygGs8"
}

功能特性

• 🔗 兼容MCP协议：支持最新的MCP 1.9.1版本
• 📝 创建笔记：统一的富文本格式，支持段落、加粗、高亮、链接、引用和内链笔记
• ✏️ 编辑笔记：统一的富文本格式，完全替换笔记内容
• 📁 文件上传：支持图片、音频、PDF文件上传，本地文件和远程URL两种方式
• 💬 引用段落：创建引用文本块，支持富文本格式
• 🔗 内链笔记：引用其他笔记，创建笔记间的关联
• 🔒 隐私设置：设置笔记的公开、私有或规则公开权限
• 🔄 密钥管理：重置API密钥功能
• 🎨 统一接口：所有笔记操作使用一致的富文本参数格式

快速开始

前提条件

• Python 3.10+
• 墨问Pro会员账号（API功能仅对Pro会员开放）
• 墨问API密钥（在墨问小程序中获取）

安装方式

方式一：从源码安装（推荐）

1. 克隆项目：

git clone https://github.com/z4656207/mowen-mcp-server.git
cd mowen-mcp-server

2. 安装依赖：

pip install -e .

方式二：直接安装依赖

pip install mcp httpx pydantic

配置 API 密钥

Windows PowerShell

$env:MOWEN_API_KEY="你的墨问API密钥"

Linux/macOS

export MOWEN_API_KEY="你的墨问API密钥"

持久化设置

创建 .env 文件：

MOWEN_API_KEY=你的墨问API密钥

配置 MCP 客户端

方式一：模块安装方式（推荐）

如果你使用了 pip install -e . 安装，在 Cursor 设置中添加：

{
  "mcpServers": {
    "mowen-mcp-server": {
      "command": "python",
      "args": ["-m", "mowen_mcp_server.server"],
      "env": {
        "MOWEN_API_KEY": "${env:MOWEN_API_KEY}"
      }
    }
  }
}

方式二：直接文件路径方式

如果你没有安装包，可以直接指定文件路径：

{
  "mcpServers": {
    "mowen-mcp-server": {
      "command": "python",
      "args": ["绝对路径/mowen-mcp-server/src/mowen_mcp_server/server.py"],
      "env": {
        "MOWEN_API_KEY": "${env:MOWEN_API_KEY}"
      }
    }
  }
}

注意: 请将 绝对路径 替换为你的实际项目路径，例如：

• Windows: "D:/CODE/mowen-mcp-server/src/mowen_mcp_server/server.py"
• macOS/Linux: "/home/user/mowen-mcp-server/src/mowen_mcp_server/server.py"

可用工具

create_note

创建一篇新的墨问笔记，使用统一的富文本格式

参数：

• paragraphs (数组，必需)：富文本段落列表，每个段落包含文本节点
• auto_publish (布尔值，可选)：是否自动发布，默认为false
• tags (字符串数组，可选)：笔记标签列表

支持的段落类型：

1. 普通段落（默认）：{"texts": [...]}
2. 引用段落：{"type": "quote", "texts": [...]}
3. 内链笔记：{"type": "note", "note_id": "笔记ID"}
4. 文件段落：{"type": "file", "file_type": "image|audio|pdf", "source_type": "local|url", "source_path": "绝对路径", "metadata": {...}}

段落格式示例：

[
  {
    "texts": [
      {"text": "普通文本"},
      {"text": "加粗文本", "bold": true},
      {"text": "高亮文本", "highlight": true},
      {"text": "链接文本", "link": "https://example.com"}
    ]
  },
  {
    "type": "quote",
    "texts": [
      {"text": "这是引用段落"},
      {"text": "支持富文本", "bold": true}
    ]
  },
  {
    "type": "note",
    "note_id": "VPrWsE_-P0qwrFUOygxxx"
  },
  {
    "type": "file",
    "file_type": "image",
    "source_type": "local",
    "source_path": "C:\\Users\\用户名\\Documents\\image.jpg",
    "metadata": {
      "alt": "图片

... [View full README on GitHub](https://github.com/z4656207/mowen-mcp-server#readme)