note.com MCP Server

基本能力

产品定位

note-mcp-server 是一个用于与 note.com 平台交互的中间件，提供 API 访问和内容管理功能。

核心功能

• 文章搜索与浏览
• 用户搜索与资料查看
• 文章发布（草稿）
• 评论查看与发布
• 点赞管理（获取、添加、删除）
• 杂志搜索与浏览
• 分类文章浏览
• PV 统计信息获取
• 内容创意生成与竞争分析

适用场景

• 内容创作者管理 note.com 上的文章
• 数据分析师获取 note.com 上的用户和文章数据
• 营销人员生成内容创意和进行竞争分析

工具列表

文章相关（无需认证）

• search-notes: 关键词搜索文章
• get-note: 通过文章 ID 获取详细信息
• get-category-notes: 获取分类文章列表

用户相关（无需认证）

• search-users: 搜索用户
• get-user: 获取用户详细信息
• get-user-notes: 获取用户文章列表

杂志相关（无需认证）

• search-magazines: 搜索杂志
• get-magazine: 获取杂志详细信息

交互相关（需认证）

• post-draft-note: 发布草稿文章
• get-comments: 获取文章评论列表
• post-comment: 发布评论
• get-likes: 获取文章点赞列表
• like-note: 点赞文章
• unlike-note: 取消点赞

统计相关（需认证）

• get-stats: 获取 PV 统计信息

常见问题解答

服务器无法启动

• 检查 .env 文件是否正确配置
• 确认 Node.js 版本为 18 或更高
• 确保依赖包已安装（运行 npm install）
• 确认 TypeScript 已成功构建（运行 npm run build）

认证错误

• 检查 Cookie 值是否最新（可能已过期）
• 尝试设置两个 Cookie 值（note_gql_auth_token 和 _note_session_v5）
• 确认功能是否需要认证

API 错误

• note.com 可能已更改 API 规范
• 获取最新版服务器或检查并修复错误代码

使用教程

使用依赖

• Node.js (v18 以上)
• npm 或 yarn
• Claude Desktop
• note.com 账户（如需使用发布功能）

安装教程

1. 克隆或下载仓库 git clone https://github.com/yourusername/note-mcp-server.git cd note-mcp-server

2. 安装依赖包 npm install

3. 移动源文件到 src 目录（如已存在则跳过） mkdir -p src mv note-mcp-server.ts src/

4. 复制 .env.example 创建 .env 文件 cp .env.example .env

5. 编辑 .env 文件设置认证信息

6. 构建 TypeScript npm run build

调试方式

1. 启动服务器 node build/note-mcp-server.js

2. 在 Claude Desktop 中测试功能

3. 搜索文章："note 上搜索 '编程' 相关热门文章"
4. 分析用户："分析用户 'username' 的文章，找出受欢迎的原因"
5. 生成内容创意："生成 5 个关于市场营销的文章创意"
6. 文章大纲："为编程相关文章构思大纲"

许可证

该项目遵循 MIT 开源许可条款。