MCP ExplorerExplorer

Mowen Mcp Server

@flyhigher139on 16 days ago
1 Apache-2.0
FreeCommunity
AI Systems
A Go server for interacting with Mowen notes via the MCP protocol.

Overview

What is Mowen Mcp Server

Mowen-MCP-Server is a Go-based server that implements the Model Context Protocol (MCP) for interaction with Mowen Note-taking software. It allows users to create, edit, and manage notes directly within MCP-compatible applications such as Cursor and Claude Desktop.

Use cases

Use cases include creating and managing personal notes, collaborating on shared projects, integrating with other applications that support MCP, and utilizing rich text formatting for enhanced note presentation.

How to use

To use Mowen-MCP-Server, clone the repository, install dependencies, set the Mowen API key as an environment variable, and run the server executable. Configure your MCP client (e.g., Cursor or Claude Desktop) to connect to the server endpoint.

Key features

Key features include compatibility with the latest MCP protocol, rich text note creation and editing, paragraph quoting, internal linking of notes, privacy settings for note visibility, API key management, and high performance due to its Go language implementation.

Where to use

Mowen-MCP-Server is suitable for personal note-taking, collaborative projects, and any application that requires structured note management and retrieval, particularly in environments that support MCP.

Content

墨问笔记 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 许可证。

🙏 致谢

Tools

No tools

Comments