PenPulse Server

让任何自媒体运营者，用 AI 完成从选题到发布的全部工作。

MCP Server Python 3.10+ License: MIT

---

两条核心链路

链路一：AI 全链路（无稿用户）
research_topic → generate_article → format_wechat_html → generate_cover → create_wechat_draft

链路二：文档上传（有稿用户）
upload_docx → format_wechat_html → generate_cover → create_wechat_draft

---

功能

MCP Tools（链路一 · AI 全链路）

Tool	功能
research_topic	搜索热门选题，基于荆州新闻网等数据源
generate_article	AI 生成文章，支持 news/humor/tech 三种风格
format_wechat_html	Markdown 转公众号内联样式 HTML
generate_cover	AI 生成封面图（通义万相）
create_wechat_draft	推送到微信公众号草稿箱

MCP Tools（链路二 · 文档上传）

Tool	功能
upload_docx	读取 Word 文档 (.docx)，转为 Markdown
format_wechat_html	同上，共用
generate_cover	同上，共用
create_wechat_draft	同上，共用

---

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置公众号账号

cp config/wechat_accounts.example.json config/wechat_accounts.json
# 编辑 config/wechat_accounts.json，填入你的 AppID 和 AppSecret

3. 设置环境变量（可选）

export PENPULSE_API_KEY="your-api-key"          # 大模型 API Key
export PENPULSE_DASHSCOPE_KEY="your-dashscope-key"  # 通义万相 API Key（封面图用）
export PENPULSE_API_BASE="https://api.qfapi.cn/v1"  # 大模型 API 地址

4. 运行 MCP Server

# STDIO 模式（用于 Claude Desktop / Cursor 等）
python mcp_server.py

# HTTP 模式（用于远程调用）
python -m uvicorn mcp_server:app --host 0.0.0.0 --port 8080

5. 在 Claude Desktop 中使用

在 ~/.claude/settings.json 中添加：

{
  "mcpServers": {
    "penpulse": {
      "command": "python",
      "args": ["/path/to/penpulse/mcp_server.py"],
      "env": {
        "PENPULSE_API_KEY": "your-api-key",
        "PENPULSE_DASHSCOPE_KEY": "your-dashscope-key"
      }
    }
  }
}

---

使用示例

链路一：AI 全链路

你：帮我写一篇关于荆州端午文旅数据的公众号文章并发布

→ research_topic("荆州 端午 文旅")
→ generate_article("荆州端午文旅数据", style="humor")
→ format_wechat_html(markdown, template_id="journal")
→ generate_cover(title, style="culture")
→ create_wechat_draft(title, html, cover_url)
→ 返回草稿预览链接

链路二：文档上传

你：帮我把 /path/to/article.docx 排版发布

→ upload_docx("/path/to/article.docx")
→ format_wechat_html(markdown, template_id="auto")
→ generate_cover(title)
→ create_wechat_draft(title, html, cover_url)
→ 返回草稿预览链接

---

排版模板

支持 12 套模板（朝鉴 6 套浅色 + 棱镜 6 套深色）：

朝鉴浅色系

ID	风格
journal	晨报头版
cover	杂志封面
card	卡片瀑布流
dashboard	数据仪表盘
minimal	极简留白
chat	对话气泡

棱镜深色系

ID	风格
terminal	终端界面
editor	代码编辑器
neon	霓虹赛博
glass	毛玻璃卡片
geek	极客简约
hologram	全息投影

---

配置多账号

from modules.publisher import add_account

add_account({
    "id": "my-account",
    "name": "我的公众号",
    "appid": "wx1234567890abcdef",
    "appsecret": "your-appsecret-here",
    "author_name": "作者名"
})

---

项目结构

penpulse/
├── mcp_server.py          # MCP Server 入口
├── modules/
│   ├── __init__.py
│   ├── research.py        # 选题搜索
│   ├── writer.py          # AI 写作
│   ├── doc_reader.py      # Word 文档读取
│   ├── formatter.py       # 公众号排版
│   ├── cover.py           # 封面图生成
│   └── publisher.py       # 公众号发布
├── config/
│   └── wechat_accounts.example.json
├── requirements.txt
└── README.md

---

定价（爱发电）

方案	价格	功能
Free	¥0	每月 5 次 API 调用
Basic	¥49/月	无限排版 + 发布（链路二）
Pro	¥99/月	全部功能（两条链路）
Enterprise	¥299/月	私有部署 + 技术支持

购买 API Key：爱发电 · PenPulse

---

常见问题

Q: 如何获取微信公众号 AppID 和 AppSecret？ A: 登录 微信公众平台 → 设置与开发 → 基本配置

Q: 通义万相 API Key 如何获取？ A: 登录 阿里云百炼 → API-KEY 管理

Q: 支持其他 AI 模型吗？ A: 支持 OpenAI/Claude 兼容接口，设置 PENPULSE_API_BASE 和 PENPULSE_MODEL_NAME 即可

---

License

MIT License · 2026 PenPulse