mowen-mcp-server

flyhigher139/mowen-mcp-server

3.2

If you are the rightful owner of mowen-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This is a Go-based server implementing the Model Context Protocol (MCP) for interaction with the Mowen Note software.

Tools

  1. create_note

    Creates a new Mowen note using a unified rich text format.

  2. edit_note

    Edits existing note content, replacing it entirely with new content.

  3. set_note_privacy

    Sets the privacy permissions for a note.

  4. reset_api_key

    Resets the Mowen API key, invalidating the current key.

墨问笔记 MCP 服务器 (Go版本)

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

✨ 功能特性

  • 🔗 兼容MCP协议：支持最新的MCP协议规范
  • 📝 创建笔记：统一的富文本格式，支持段落、加粗、高亮、链接、引用和内链笔记
  • ✏️ 编辑笔记：统一的富文本格式，完全替换笔记内容
  • 💬 引用段落：创建引用文本块，支持富文本格式
  • 🔗 内链笔记：引用其他笔记，创建笔记间的关联
  • 🔒 隐私设置：设置笔记的公开、私有或规则公开权限
  • 🔄 密钥管理：重置API密钥功能
  • ⚡ 高性能：基于Go语言，具有出色的并发性能和低资源占用

🚀 快速开始

前提条件

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

安装和运行

  1. 克隆项目：
git clone <repository-url>
cd mowen-v1
  1. 安装依赖：
go mod tidy
  1. 设置环境变量：

macOS/Linux:

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

Windows PowerShell:

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

持久化设置 - 创建 .env 文件：

MOWEN_API_KEY=你的墨问API密钥
  1. 运行服务器： 找到适配你的操作系统和架构的可执行文件（如mowen-mcp-darwin-arm64），并运行：
./mowen-mcp-darwin-arm64

Windows 系统直接双击 exe文件 运行即可

服务器将在 http://127.0.0.1:8080 启动，SSE端点为 http://127.0.0.1:8080/sse。

V0.2 版本的服务，已经改为streamable_http，不再需要sse，直接使用http即可

服务器将在 http://127.0.0.1:8080 启动，MCP 的端点为：http://127.0.0.1:8080/mcp

配置 MCP 客户端

在 Cursor 或 Claude Desktop 的设置中添加以下配置：

{
  "mcpServers": {
    "墨问MCP": {
      "url": "http://127.0.0.1:8080/mcp"
    }
  }
}

🛠️ 可用工具

create_note

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

参数：

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

支持的段落类型：

  • 普通段落（默认）：{"texts": [...]}
  • 引用段落：{"type": "quote", "texts": [...]}
  • 内链笔记：{"type": "note", "note_id": "笔记ID"}

段落格式示例：

[
  {
    "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"
  }
]

edit_note

编辑已存在的笔记内容，使用统一的富文本格式

参数：

  • note_id (字符串，必需)：要编辑的笔记ID
  • paragraphs (数组，必需)：富文本段落列表，将完全替换原有内容

注意：此操作会完全替换笔记的原有内容，而不是追加内容。

set_note_privacy

设置笔记的隐私权限

参数：

  • note_id (字符串，必需)：笔记ID
  • privacy_type (字符串，必需)：隐私类型（public/private/rule）
  • no_share (布尔值，可选)：是否禁止分享（仅rule类型有效）
  • expire_at (整数，可选)：过期时间戳（仅rule类型有效，0表示永不过期）

reset_api_key

重置墨问API密钥

注意：此操作会使当前密钥立即失效。

📁 项目结构

mowen-v1/
├── main.go          # 主程序入口
├── server.go        # MCP服务器实现
├── client.go        # 墨问API客户端
├── types.go         # 数据结构定义
├── go.mod           # Go模块定义
└── README.md        # 项目文档

🔧 技术栈

  • Go 1.21+: 主要编程语言
  • go-mcp: MCP协议实现库
  • net/http: HTTP客户端用于API调用
  • encoding/json: JSON序列化/反序列化

📝 使用示例

创建简单文本笔记

{
  "paragraphs": [
    {
      "texts": [
        {"text": "今天学习了Go编程，重点是并发编程概念"}
      ]
    }
  ],
  "auto_publish": true,
  "tags": ["学习", "Go", "编程"]
}

创建富文本笔记

{
  "paragraphs": [
    {
      "texts": [
        {"text": "重要提醒：", "bold": true},
        {"text": "明天的会议已改期"}
      ]
    },
    {
      "type": "quote",
      "texts": [
        {"text": "会议时间：", "bold": true},
        {"text": "下周三上午10点"}
      ]
    }
  ]
}

🤝 贡献

欢迎提交Issue和Pull Request来改进这个项目！

📄 许可证

本项目采用 Apache-2.0 许可证。

🙏 致谢