使用说明

note.com MCP服务器

是利用note.com的API，可以从Claude Desktop、Claude Code、Cursor、n8n等MCP客户端检索、投稿、分析报道的MCP服务器。

支持本地和远程传输。

🚀 快速启动

1.安装

git clone https://github.com/shimayuz/note-com-mcp.git
cd note-com-mcp
npm install
npx playwright install chromium  # ブラウザ自動ログイン用
npm run build

2.认证设定

cp .env.sample .env

.env 编辑：

NOTE_EMAIL=your-email@example.com
NOTE_PASSWORD=your-password
NOTE_USER_ID=your_note_user_id

启动时，Playwright自动进行headless登录，获取并更新会话Cookie。不需要手动设置Cookie。

安全性: .env文件是.gitignore中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

3.起动

Stdioモー"（克劳德桌面/克劳德代码/光标）：

npm run start

HTTP模式（n8n/远程连接）：

npm run start:http
# デフォルトポートは3000。変更する場合：
MCP_HTTP_PORT=3001 node build/note-mcp-server.js

🔌 传输

stdio模式（默认）

直接从本地MCP客户端启动的标准连接方法。

node build/note-mcp-server.js

HTTP模式

用于从远程客户端或n8n连接的基于HTTP的连接方式。MCP_HTTP_PORT环境变量或--http将条目添加到文档注册表。

# 環境変数で指定
MCP_HTTP_PORT=3000 node build/note-mcp-server.js

# CLIフラグで指定（ポートはMCP_HTTP_PORTまたはデフォルト3000）
node build/note-mcp-server.js --http

｜端点｜方法｜说明｜ |---------------|---------|------| | /mcp ｜开机自检｜MCP JSON-RPC请求｜ | /mcp 获得SSE流 | /mcp 会话结束 | /health 获得：健康检查

默认绑定地址为127.0.0.1是。MCP_HTTP_HOST可以在环境变量中更改。

✨ 主要功能

｜类别｜功能｜认证｜ |---------|------|------| | 🔍 搜索｜文章搜索、用户搜索、散列标签搜索｜不需要｜ | 📊 分析｜文章分析、娱乐分析｜不需要｜ |✍️ 投稿|下书き作成、画像付き投稿|必须| | 🖼️ 图像｜图像上传、眼捕捉设置｜必需｜ | 💬 注释｜评论投稿、滑雪功能｜必需｜ | 📈 统计信息｜PV数、访问分析｜必需｜

📋 可用工具

検索・分析（认证不要）

search-notes -记事検索（新着/人气/急上升）
search-all - note全体検索
analyze-notes -记事详细分析
get-note -记事详细取得
search-users -用户搜索
get-user -获取用户信息
get-user-notes -用户文章列表
search-magazines -杂志搜索
get-magazine -杂志详细信息
get-category-notes -按类别列出的文章
list-categories -类别列表
list-hashtags -哈希标记列表
get-hashtag -散列标记详细信息
get-comments -注释列表
get-likes -芒草列表
list-contests -比赛列表

投稿・编集（认证必须）

post-draft-note -下书き作成（Markdown自动变换）
get-my-notes -我的文章列表（包括草稿）
open-note-editor -打开编辑文章页面

交互（需要验证）

post-comment -评论文章
like-note / unlike-note -滑雪功能
add-magazine-note / remove-magazine-note -杂志管理
get-stats - PV统计情报
get-notice-counts - 通知件数
get-search-history - 検索履歴

成员资格（必须认证）

get-membership-summaries -已加入的成员资格列表
get-membership-plans -成员资格计划列表
get-membership-notes -成员资格文章列表
get-circle-info -社团信息

🔧 设定方法

克劳德桌面

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "note-api": {
      "command": "node",
      "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"],
      "env": {
        "NOTE_EMAIL": "your_email@example.com",
        "NOTE_PASSWORD": "your_password",
        "NOTE_USER_ID": "your_note_user_id"
      }
    }
  }
}

克劳德代码

~/.claude/settings.json 的，之 mcpServers 添加到：

{
  "mcpServers": {
    "note-api": {
      "command": "node",
      "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"],
      "cwd": "/path/to/note-com-mcp",
      "env": {
        "NOTE_EMAIL": "your_email@example.com",
        "NOTE_PASSWORD": "your_password",
        "NOTE_USER_ID": "your_note_user_id"
      }
    }
  }
}

光标

~/.cursor/mcp.json:

{
  "mcpServers": {
    "note-api": {
      "command": "node",
      "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"],
      "env": {
        "NOTE_EMAIL": "your_email@example.com",
        "NOTE_PASSWORD": "your_password",
        "NOTE_USER_ID": "your_note_user_id"
      }
    }
  }
}

帆板运动

~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "note-api": {
      "command": "node",
      "args": ["/path/to/note-com-mcp/build/note-mcp-server.js"],
      "env": {
        "NOTE_EMAIL": "your_email@example.com",
        "NOTE_PASSWORD": "your_password",
        "NOTE_USER_ID": "your_note_user_id"
      }
    }
  }
}

/path/to/note-com-mcp 请用实际项目的绝对路径替换。

n8n（HTTP経由）

启动HTTP服务器：

npm run start:http

在n8n中设置“MCP客户端HTTP流”节点：

HTTP Stream URL: http://127.0.0.1:3000/mcp
HTTP Connection Timeout: 60000

🌐 远程访问

在VPS中使用n8n时，可以通过Cloudflare Tunnel安全连接：

# 1. Cloudflare Tunnelを設定
cloudflared tunnel run note-mcp

# 2. n8nでHTTPS URLを設定
# HTTPS Stream URL: https://your-domain.com/mcp

🔐 验证流程

启动时按以下顺序获取凭据：

NOTE_EMAIL / NOTE_PASSWORD 如果设置了，则在Playwright中执行headless登录，自动获取最新的会话Cookie
Playwright失败时 .env 的现有Cookie信息
如果两者都没有，则Playwright打开浏览器，请求手动登录

会话Cookie是自动的.env中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

📝 标记转换规则

投稿时的Markdown会自动转换为note.com用HTML。

Markdown	note.com	HTML
`# H1` / `## H2` 大标题 `<h2>`
`### H3` 小标题 `<h3>`
`#### H4-H6`	太字	`<strong>`
`![[image.png]]`	画像	`<figure><img>`
`- リスト` ｜项目符号｜ `<ul><li>`

💡 用法示例

记事検索（认证不要）

noteで「プログラミング」に関する人気記事を検索して

画像付き投稿（认证必须）

タイトル「技術メモ」、本文「## 概要\n\n![[screenshot.png]]」で下書きを作成して

记事分析（认证不要）

ユーザー「username」の記事を分析して、人気の要因を教えて

⚠️ 注意点

投稿机能：仅支持草稿。请直接从note.com进行公开
画像：支持形式为PNG、JPEG、GIF（最大10MB）
検索结果：最多可获得20个
认证：会话Cookie将在约1-2周内到期，但如果已设置邮件/密码，则会自动更新

🛠️ 开発

# ビルド
npm run build

# 開発モード（ファイル監視）
npm run dev:watch

# HTTPサーバー開発
npm run dev:http

📄 许可证

MIT许可证