How do I use cnblogs-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

de en es ja ko ru zh

cnblogs-mcp

by mintonzhang

Overview Schema Source Related Servers Discussions Admin

Python

Local

cnblogs MCP Server

Wraps the cnblogs Open API into tools callable by AI via the MCP (Model Context Protocol) protocol. Allows you to publish cnblogs posts directly using natural language in any MCP client (QwenPaw, Claude Desktop, Cline, etc.).

Features

✅ create_post — Publish Markdown blog posts to cnblogs
✅ Token managed via .env, no hardcoding
✅ Supports integration with any MCP client

Related MCP server: Dev.to Blog Publisher MCP Server

Quick Start

1. Clone / Download the project

git clone https://github.com/你的用户名/cnblogs-mcp.git
cd cnblogs-mcp

2. Create a virtual environment

python -m venv .venv
source .venv/bin/activate      # macOS / Linux
# .venv\Scripts\activate       # Windows

3. Install dependencies

pip install -r requirements.txt

4. Configure Token

cp .env.example .env

Edit .env and fill in your cnblogs Personal Access Token:

CNBLOGS_TOKEN=your_token_here

5. Run tests

# 验证 MCP 服务能正常启动
printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' \
  | python cnblogs_mcp.py 2>/dev/null | grep '"name"'

Normal output:

{"jsonrpc":"2.0","id":2,"result":{"tools":[{"name":"create_post",...}]}}

Get Token

Log in to cnblogs
Go to Personal Settings → Security Settings → Personal Access Token
Click "Create Token", fill in the name and permissions (requires "Post Blog" permission)
Copy the generated Token and fill it into the .env file

⚠️ The Token is only displayed once, please save it properly.

Client Integration

1. QwenPaw

Find agent.json in the QwenPaw working directory and add the MCP client:

{
  "mcp": {
    "clients": {
      "cnblogs": {
        "name": "cnblogs",
        "description": "博客园博文发布",
        "enabled": true,
        "transport": "stdio",
        "command": "/absolute/path/to/cnblogs-mcp/.venv/bin/python",
        "args": ["/absolute/path/to/cnblogs-mcp/cnblogs_mcp.py"],
        "env": {
          "DOTENV_PATH": "/absolute/path/to/cnblogs-mcp/.env"
        }
      }
    }
  }
}

Restart QwenPaw:

qwenpaw daemon restart

2. Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "cnblogs": {
      "command": "/absolute/path/to/cnblogs-mcp/.venv/bin/python",
      "args": ["/absolute/path/to/cnblogs-mcp/cnblogs_mcp.py"],
      "env": {
        "DOTENV_PATH": "/absolute/path/to/cnblogs-mcp/.env"
      }
    }
  }
}

Restart Claude Desktop.

3. Cline / Roo Code

Search for "MCP" in VS Code settings, find MCP Servers, and add:

{
  "cnblogs": {
    "command": "/absolute/path/to/cnblogs-mcp/.venv/bin/python",
    "args": ["/absolute/path/to/cnblogs-mcp/cnblogs_mcp.py"],
    "env": {
      "DOTENV_PATH": "/absolute/path/to/cnblogs-mcp/.env"
    }
  }
}

4. Other MCP Clients

General configuration template:

Parameter	Value
`command`	`.venv/bin/python` (Python in the project virtual environment)
`args`	`["./cnblogs_mcp.py"]`
`env.DOTENV_PATH`	Absolute path to the `.env` file

💡 If the MCP client does not support DOTENV_PATH, you can also pass the token directly using env.CNBLOGS_TOKEN.

Manual Testing

cd cnblogs-mcp

# 测试 1：初始化 + 工具列表
printf '...' | python cnblogs_mcp.py

# 测试 2：发布一篇博文
printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"create_post","arguments":{"title":"测试","body":"## 你好\n\n这是一篇测试文章。"}}}\n' | python cnblogs_mcp.py 2>/dev/null

Normal return:

{"success": true, "postId": 12345678, "postUrl": "https://www.cnblogs.com/你的博客名/p/12345678"}

Error Handling

Error Message	Reason	Solution
`CNBLOGS_TOKEN not configured`	`.env` not configured or path error	Check if `.env` file exists and `DOTENV_PATH` is correct
`API Error: 401`	Token invalid or expired	Re-create Token on cnblogs
`API Error: 403`	Insufficient Token permissions	Ensure "Post Blog" is checked when creating the Token
`API Error: 400`	Request format error	Check if title and body are empty
`Request timeout`	Network issue	Check network and retry
Tool list empty after MCP connection	`show_banner` issue	Ensure `mcp.run(show_banner=False)` is used

API Reference

Tool: create_post

Parameters:

Parameter	Type	Required	Description
`title`	string	✅	Blog post title
`body`	string	✅	Blog post body (Markdown format)

Return Value:

{
  "success": true,
  "postId": 19246558,
  "postUrl": "https://www.cnblogs.com/你的博客名/p/19246558"
}

Or on error:

{
  "success": false,
  "error": "错误描述"
}

Development

Project Structure

cnblogs-mcp/
├── cnblogs_mcp.py     # MCP 服务主文件
├── requirements.txt   # Python 依赖
├── .env.example       # 环境变量模板（不含真实 Token）
├── .env               # 你的本地配置（已在 .gitignore 中）
├── .gitignore
├── README.md
└── LICENSE

Dependencies

fastmcp>=3.0.0
python-dotenv>=1.0.0
requests>=2.31.0

License

MIT — Stars, Forks, and PRs are welcome!

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

mkdshare.DEVA
io.github.PhilipAnd
Publish and share access-controlled Markdown documents from any MCP-enabled AI tool.
Content Management Systems Documentation Access Developer Tools
112
https://mkdshare.dev/mcp
blogbat
io.github.itsryanarmani
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Content Management Systems Marketing
1
https://blogbat.com/api/v1/mcp
blogbat
io.github.pooriaarab
Hosted MCP for BlogBat: read, write, generate, and publish blog articles and content.
Content Management Systems Marketing Workplace & Productivity
1
https://blogbat.com/api/v1/mcp
JustBloggedA
io.github.usamaejaz
Create, edit, organize, publish, and configure JustBlogged blogs from MCP clients.
Content Management Systems Marketing
481
https://justblogged.com/mcp

Related MCP Servers

velog-mcp
Content Management Systems
mrpumpkin98
A
license
A
quality
C
maintenance
Enables publishing local Markdown files to Velog with idempotent updates. Supports login, post management, and series operations through natural language.
Updated 3 months ago (2026-07-29 02:28 UTC)
10
MIT
Dev.to Blog Publisher MCP
Content Management Systems Marketing
Dineshv0311
A
license
A
quality
D
maintenance
Enables publishing markdown blog posts directly to Dev.to as drafts or live articles through a single MCP tool, with support for tags, series, canonical URL, and cover image.
Updated 3 months ago (2026-08-01 05:26 UTC)
1
MIT
naver-blog-mcp
Content Management Systems Browser Automation
jjorae
A
license
A
quality
B
maintenance
Enables writing Naver blog posts with rich formatting like images, tables, formulas, and places, converting Markdown to drafts and handling publishing via MCP tools.
Updated a month ago (2026-10-12 00:23 UTC)
7
MIT
velog-mcp
Content Management Systems
pockta11
A
license
B
quality
C
maintenance
Automates writing and publishing posts to velog.io via MCP, including login and session management.
Updated 2 months ago (2026-09-09 09:01 UTC)
5
23 npm
MIT