NodeSeek Model Context Protocol (MCP) Server

这是一个为 NodeSeek 论坛开发的非官方 Model Context Protocol (MCP) 服务器。通过本服务器，大语言模型（如 Claude, GPT）可以直接在编辑器（如 Cursor, Claude Desktop）中与 NodeSeek 论坛进行交互，支持获取个人状态、每日签到、浏览贴子、阅读内容（自动转为 Markdown）、发布回复、发表新主题等功能。

本项目采用逆向 API 模拟方式开发，使用 curl_cffi 强力模拟 Chrome 120 的 JA3 与 HTTP/2 指纹特征，能够无缝绕过 NodeSeek 论坛的 Cloudflare 防护，运行迅速、资源占用极小，无需依赖重量级的无头浏览器。

---

🛠️ 包含的 MCP 工具

本服务器向大语言模型开放了以下 8 个核心工具：

1. get_user_status：获取已登录用户的账户信息（如：用户 ID、昵称、鸡腿/金币数、星辰数、等级、发贴/回帖数、未读消息等）。
2. check_in：执行论坛每日签到，自动获取鸡腿福利（支持随机和固定签到模式）。
3. list_posts：获取论坛主页或指定板块（如 daily 日常, tech 技术, sandbox 沙盒）的帖子列表。
4. view_post：阅读某一帖子的正文及所有楼层评论，自动转换为精美的 Markdown 格式便于 LLM 理解。
5. publish_comment：对指定帖子发表评论回复。
6. publish_post：在指定板块（推荐测试在 sandbox 沙盒版块）发布新主题贴。
7. list_notifications：拉取账户的未读系统通知（提到我的、回复我的）。
8. list_messages：拉取站内私信会话列表。

---

📥 安装与运行步骤

1. 安装依赖

在项目根目录运行以下命令安装必要的 Python 依赖：

pip install -r requirements.txt

2. 配置账户 Cookie

为了调用权限接口（如签到、发帖、读私信等），需要配置你的登录 Cookie：

1. 复制同级目录下的 config.json.example 并重命名为 config.json：

   {
     "cookie": "YOUR_COOKIE_HERE",
     "base_url": "https://www.nodeseek.com",
     "proxy": ""
   }
   

2. 使用 Chrome 浏览器登录 NodeSeek 论坛。
3. 按下 F12 打开开发者工具，进入 Network (网络) 标签页。
4. 刷新一下页面，点击任意一个请求（例如 www.nodeseek.com 或 api/ 下的请求）。
5. 在右侧 Headers (头部) 详情中的 Request Headers (请求标头) 里找到 cookie: ...，将其完整值复制下来。
6. 将复制的 Cookie 填入 config.json 的 cookie 字段中（或设置为环境变量 NODESEEK_COOKIE）。

3. 运行测试

在填入正确的 Cookie 后，可以运行模拟测试脚本来检查连接和解析情况：

# Windows 环境下如果包含 Emoji 等字符，建议设置 UTF-8 编码运行：
$env:PYTHONIOENCODING="utf-8"
python test_client.py

4. 在 MCP 客户端中配置

1) 配合 Cursor 使用

打开 Cursor 软件，依次进入 Settings -> Features -> MCP：

• 点击 + Add New MCP Server
• Name: NodeSeek
• Type: command
• Command:

  python D:/Project/nodeseek-mcp/server.py
  

  (请根据你本地的绝对路径进行相应调整)

2) 配合 Claude Desktop 使用

在 %APPDATA%\Claude\claude_desktop_config.json 配置文件中添加以下内容：

{
  "mcpServers": {
    "nodeseek": {
      "command": "python",
      "args": [
        "D:/Project/nodeseek-mcp/server.py"
      ]
    }
  }
}

---

⚠️ 安全与合规说明

• 凭据安全：本工具仅在本地运行，你的 Cookie 信息仅保存在本地 config.json 文件或你的环境变量中，绝对不会上传到任何第三方服务器。请妥善保管好包含 Cookie 的配置文件。
• 合理使用：自动化签到、发帖和评论建议设置合理的间隔时间，请勿利用本工具进行高频恶意刷帖、发小广告等违反 NodeSeek 论坛使用协议 (TOS) 的行为，避免触发论坛防护导致账号被封禁。