Leanote

Cursor、ClaudeCode、Copliot可用的 MCP 服务，对接自建 Leanote 笔记。多人共用同一 MCP 服务，各用户使用自己的 Leanote 账号。

工具	说明
leanote_list_notebooks	列出笔记本，获取 NotebookId
leanote_create_note	在指定笔记本中新建笔记

部署 MCP 服务

支持 Docker 与 npm 两种方式，环境变量含义相同。

变量	说明
MCP_HOST / MCP_PORT	HTTP 监听地址与端口，默认 0.0.0.0:3100
LEANOTE_BASE_URL	Leanote 服务地址

不要写入用户凭据，凭据由 Cursor 请求头传入。

Docker

服务器需安装 Docker 与 Docker Compose。

git clone <repo-url> /opt/leanote-mcp
cd /opt/leanote-mcp

编辑 docker-compose.yml 中的环境变量：

environment:
  MCP_HOST: ${MCP_HOST:-0.0.0.0}
  MCP_PORT: ${MCP_PORT:-3100}
  LEANOTE_BASE_URL: ${LEANOTE_BASE_URL:-http://your-leanote-host:9002}

docker compose up -d --build
# 或
./deploy-docker.sh

npm

服务器需安装 Node.js >= 18。

git clone <repo-url> /opt/leanote-mcp
cd /opt/leanote-mcp
cp env.example .env
# 编辑 .env，设置 LEANOTE_BASE_URL
npm install
npm run build
npm start

.env 示例（见 env.example）：

MCP_HOST=0.0.0.0
MCP_PORT=3100
LEANOTE_BASE_URL=http://your-leanote-host:9002

生产环境推荐使用 systemd 一键部署：

./deploy-npm.sh

首次运行会创建 .env 并提示编辑；再次执行将安装/重启 leanote-mcp 服务。也可手动安装：

sudo cp leanote-mcp.service.example /etc/systemd/system/leanote-mcp.service
# 修改 WorkingDirectory、EnvironmentFile 为实际路径
sudo systemctl daemon-reload
sudo systemctl enable --now leanote-mcp

远程部署

从 Windows 本机上传并部署（需配置 SSH）：

# Docker（默认）
.\deploy-remote.ps1 -Server your-server

# npm
.\deploy-remote.ps1 -Server your-server -DeployMode npm

验证

curl http://your-mcp-host:3100/health
# {"status":"ok","service":"leanote-mcp"}

配置 Cursor

各用户在自己的 %USERPROFILE%\.cursor\mcp.json 中连接 MCP 地址，并通过请求头传入自己的 Leanote 凭据。

API Token（推荐）

{
  "mcpServers": {
    "leanote": {
      "type": "http",
      "url": "http://your-mcp-host:3100/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LEANOTE_TOKEN}"
      }
    }
  }
}

在系统环境变量中设置 LEANOTE_TOKEN（不要写进代码仓库）。

邮箱 + 密码

{
  "mcpServers": {
    "leanote": {
      "type": "http",
      "url": "http://your-mcp-host:3100/mcp",
      "headers": {
        "X-Leanote-Email": "${env:LEANOTE_EMAIL}",
        "X-Leanote-Password": "${env:LEANOTE_PASSWORD}"
      }
    }
  }
}

也可使用 X-Leanote-Token 代替 Authorization: Bearer。

完整示例见 mcp.example/cursor-mcp.example.json。重启 Cursor 后即可在 Agent 对话中使用上述工具。

配置 Claude Code或者Copilot

见 mcp.example

配置参考

HTTP 请求头

请求头	说明
Authorization: Bearer <token>	Leanote API Token
X-Leanote-Token	同上
X-Leanote-Email + X-Leanote-Password	邮箱密码登录