get_style_guide → generate_blog_scaffold → 填充正文 → write_blog → seo_check → csdn_login(首次) → publish_csdn → csdn_stats

┌──────────────────────────────────────────────┐
│              AI Agent (Cursor / Claude)        │
│                  通过 MCP 协议调用               │
└──────────────────────┬───────────────────────┘
                       │
                       ▼
┌──────────────────────────────────────────────┐
│            csdn-blog-mcp Server               │
│              (FastMCP, 14 个工具)              │
├──────────┬──────────┬──────────┬──────────────┤
│  写博文   │  草稿库   │  发布登录  │   统计/限流    │
│ (4 tools)│ (3 tools)│ (5 tools)│  (2 tools)  │
├──────────┴──────────┴──────────┴──────────────┤
│                  底层能力                       │
│  Markdown 解析 │ YAML front-matter │ Playwright │
└──────────────────────────────────────────────┘
                       │
                       ▼
┌──────────────────────────────────────────────┐
│         CSDN 网页编辑器 / 公开统计 API           │
└──────────────────────────────────────────────┘

csdn-blog-mcp/
├── src/csdn_blog_mcp/
│   ├── server.py          # MCP 服务入口 + 工具注册
│   ├── writer.py          # 写博文：generate_blog_scaffold / write_blog
│   ├── seo.py             # SEO 自检：seo_check
│   ├── library.py         # 草稿库：list / read / delete
│   ├── auth.py            # 登录态：check_login / login / clear_session
│   ├── publisher.py       # 发布：publish_csdn（Playwright 方案 A）
│   ├── stats.py           # 统计：csdn_stats（公开 API）
│   ├── style.py           # 风格指南加载：get_style_guide
│   ├── util.py            # run_in_thread：让浏览器工具绕开 MCP 的 asyncio 循环
│   └── config.py          # 路径 / cookie 存储 / 频率限制
├── STYLE_GUIDE.md         # 从作者博文提炼的写作风格提示词（MCP 自用）
├── drafts/                # 本地草稿存放处（git 忽略）
├── pyproject.toml
├── .gitignore
├── README.md             # 中文（默认，Gitee 首页展示）
└── README.en.md           # English

git clone https://gitee.com/gdouage/csdn-mcp.git
cd csdn-mcp

# 创建虚拟环境
python -m venv .venv

# Windows
.venv\Scripts\pip install -e .
.venv\Scripts\playwright install chromium

# macOS / Linux
.venv/bin/pip install -e .
.venv/bin/playwright install chromium

{
  "mcpServers": {
    "csdn-blog-mcp": {
      "command": "<项目路径>/.venv/Scripts/python.exe",
      "args": ["-m", "csdn_blog_mcp.server"],
      "env": {
        "PYTHONPATH": "<项目路径>/src"
      }
    }
  }
}

get_style_guide()                  # 先读风格提示词，对齐作者语气/结构
generate_blog_scaffold("Playwright 自动化", ["playwright","python","爬虫"], "tutorial")
  → 拿到骨架，AI 按风格指南填充正文
write_blog(topic="Playwright 自动化完全指南", content=<填充后的正文>, tags=[...])
  → 保存草稿，拿到 file_path
seo_check(file_path)
  → 看评分，按建议修改
csdn_login()                      # 首次登录（会弹浏览器，手动登录）
publish_csdn(file_path)           # 默认存入 CSDN 草稿箱（不公开）
# 审阅满意后，在 CSDN 后台手动点发布；或 publish_csdn(file_path, as_draft=False) 直接发
csdn_stats(article_url)           # 直接发布后看数据

get_style_guide → generate_blog_scaffold → 填充 → write_blog → seo_check
# 草稿留在 drafts/，手动复制到 CSDN 编辑器发布（5 秒的事）

rate_limit_status()       # 今天还能发吗？
check_csdn_login()         # session 还有效吗？
publish_csdn(file_path)   # 都 OK 再发

Copyright (c) 2026 abbuibuibui