mowen

The mowen MCP server is a Go-based MCP implementation that lets Curve-Cursor/Claude Desktop style MCP clients interact with Mowen Notes. It exposes endpoints that allow creating, editing, and managing notes in a standardized MCP format, including rich text paragraphs, quotes, and internal note references. The server supports operations such as creating a new note with structured paragraphs (plain text, bold, highlight, links), editing an existing note by replacing its content, setting privacy options for notes, and resetting the API key for integration with Mowen’s API service. You can configure MCP clients to talk to the server by pointing them to the local HTTP endpoint (default http://127.0.0.1:8080) and ensuring the MOWEN_API_KEY environment variable is provided so requests are authenticated.

Key tools exposed by the server include:

• create_note: build and publish a new note using a unified rich-text format with support for paragraphs, quotes, and internal note references.
• edit_note: replace the content of an existing note using the same rich-text structure.
• set_note_privacy: adjust privacy settings for a given note (public, private, or rule-based with options like no_share and expire_at).
• reset_api_key: generate a new API key to invalidate the previous one.

Example usage flows include creating a rich-text note with normal paragraphs, a quote section, and an internal note reference, followed by optionally publishing it and tagging it for discovery. You can also edit an existing note to replace its content entirely, or switch its privacy mode to public or private as needed.

Prerequisites:

• Go 1.21+ installed on your system
• Access to the MOWEN API key for authorization

Installation steps:

1. Clone the repository and enter the project directory:

git clone <repository-url>
cd mowen-v1

2. Resolve dependencies:

go mod tidy

3. Set the API key in your environment (example for macOS/Linux):

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

Alternatively, persist it in a .env file:

MOWEN_API_KEY=你的墨问API密钥

4. Run the MCP server:

go run .

The server will start at http://127.0.0.1:8080 and expose the SSE endpoint at http://127.0.0.1:8080/sse

Configuration for MCP clients (example):

{
  "mcpServers": {
    "mowen-mcp-server": {
      "command": "go",
      "args": ["run", "."],
      "cwd": "/path/to/mowen-v1",
      "env": {
        "MOWEN_API_KEY": "${env:MOWEN_API_KEY}"
      }
    }
  }
}

Notes and tips:

• Ensure Go 1.21+ is installed for compatibility with the Go MCP implementation.
• Set MOWEN_API_KEY in the environment where the server runs; the server uses this key to authenticate requests to the Mowen API.
• If you modify the working directory for the MCP server in your client config, ensure the cwd path points to the mowen-v1 project root.
• The defaults assume the server listens on http://127.0.0.1:8080; if you run behind a proxy or in a container, adjust API endpoints accordingly.
• For production deployments, consider running behind a reverse proxy and enabling TLS termination, and securely managing environment variables.
• If you encounter issues with the API key, use reset_api_key to rotate credentials and update your client configurations.