项目简介

这是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在让LLM客户端（如Claude Desktop）能够便捷地访问日本内容平台 Note.com 的内容和功能。通过此服务器，LLM可以检索文章、用户信息、杂志信息，并进行文章投稿、评论、点赞等互动操作。

主要功能点

• 文章检索与浏览
• 用户信息检索与浏览
• 杂志信息检索与浏览
• 文章投稿（下書き - 草稿）
• 评论的查看与发布
• 点赞（スキ）的管理
• 分类文章浏览
• PV统计信息获取 (需认证)

安装步骤

1. 确保已安装 Node.js (v18 或以上) 和 npm 或 yarn。
2. 克隆或下载此仓库到本地。
3. 在仓库根目录下，运行 'npm install' 安装依赖包。
4. 复制 '.env.example' 文件并重命名为 '.env'，根据需要配置 Note.com 的 Cookie 认证信息（如果需要使用投稿、点赞等需要认证的功能）。
5. 运行 'npm run build' 构建项目。

服务器配置

要将此 MCP 服务器与 Claude Desktop 等 MCP 客户端连接，您需要配置客户端的配置文件。以 Claude Desktop 为例，在 'claude_desktop_config.json' 文件中添加如下配置：

{
  "mcpServers": {
    "note-api": {
      "command": "node",
      "args": [
        "/path/to/note-mcp-server/build/note-mcp-server.js"  // 请替换为实际的 note-mcp-server.js 文件路径
      ]
      // 如果需要使用需要认证的功能，请添加 env 配置
      // , "env": {
      //   "NOTE_GQL_AUTH_TOKEN": "您的 note_gql_auth_token",
      //   "NOTE_SESSION_V5": "您的 _note_session_v5"
      // }
    }
  }
}

• 'command': 设置为 'node'，表示使用 Node.js 运行服务器。
• 'args': 包含服务器启动脚本的路径，请将 '/path/to/note-mcp-server/build/note-mcp-server.js' 替换为实际的 'note-mcp-server.js' 文件在您电脑上的路径。
• 'env' (可选): 用于配置环境变量，如果需要使用文章投稿、评论、点赞等需要 Note.com 账户认证的功能，请取消注释 'env' 部分，并填入从 Note.com 获取的 Cookie 值。

基本使用方法

配置完成后，在 Claude Desktop 中，您可以使用自然语言指令来调用 Note.com 的功能。例如：

• "在note上搜索关于『编程』的热门文章"
• "分析用户『[用户名]』的文章，找出受欢迎的原因"
• "为营销主题撰写5个文章创意"
• "我想写一篇关于编程的文章，请帮我构思一个大纲"

对于需要认证的功能 (配置 Cookie 后才能使用)，例如：

• "告诉我我的note账户最新文章的PV数"
• "给这篇文章点赞"
• "在这篇文章下评论 '内容很棒！'"