Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CSDN_COOKIEYes认证凭据。所有写操作的必填项。
CSDN_APP_KEYNobizapi 网关 app key(公开常量)203803574
CSDN_API_BASENobizapi 网关地址https://bizapi.csdn.net
CSDN_USERNAMENoCookie 里没有 UserName 时使用
CSDN_BLOG_BASENo公开页地址,用于写后校验https://blog.csdn.net
CSDN_LOG_LEVELNo日志级别:silent / error / warn / info / debug,日志走 stderrwarn
CSDN_APP_SECRETNobizapi 网关签名密钥9znpamsyl2c7cdrr9sas0le9vbc3r6ba
CSDN_TIMEOUT_MSNo单次请求超时20000
CSDN_USER_AGENTNo请求头 User-AgentChrome 131 UA
CSDN_MAX_RETRIESNo可重试失败的额外尝试次数2
CSDN_COMMUNITY_BASENo社区列表接口地址https://blog.csdn.net
CSDN_MIN_INTERVAL_MSNo普通请求之间的最小间隔250
CSDN_SAVE_INTERVAL_MSNo写操作之间的最小间隔(CSDN 约 10s 内会拒绝)11000

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
auth_loginA

在运行期设置/更新 CSDN Cookie(整段 Cookie 头),设置后立即对所有后续请求生效,不需要重启 MCP 进程。结构校验完全在本地完成:缺少 UserToken 或 UserName 时直接返回原因,不发任何请求。仅在首次配置或 Cookie 失效后才需要调用;只想知道当前状态请用 auth_status(不发网络请求)。它不判断 Cookie 是否被 CSDN 接受——结构合法但已经失效的 Cookie,只有后续需要登录的调用才会暴露。

auth_statusA

报告 Cookie 是否已配置、结构是否有效以及账号名,不发任何网络请求。它不判断 Cookie 是否被 CSDN 接受(那要联网),也不知道文章状态。需要更换 Cookie 时用 auth_login,不要靠反复调用本工具排查失效——失效只有联网调用才看得出来。

publish_articleA

新建一篇文章并保存到 CSDN。mode 默认 draft(存草稿);显式传 mode=publish 才会公开发布,且发布后接口无法退回草稿——已发布的文章只能删除重建,所以想先审稿就保持默认。markdown 传源码(会渲染成 HTML 保存,原文同时保留);tags 最多 5 个;description 省略时按正文自动生成。不要用它更新已有文章(那会新建一篇),也不要传 mode=publish 来"试试能不能成功"——发布是不可逆的对外动作。

update_articleA

更新已有文章:只传要改的字段,未传的字段保持原值(saveArticle 会整条重写,所以未传的字段由本工具从当前记录合并回来)。已公开发布文章的线上正文(markdown)不会被接口更新:正文修改只写入草稿副本,需要在编辑器 UI 里重新发布才生效,工具会在返回里明确说明。不传 mode 时保持文章当前可见性(不会把已发布的文章退回草稿);想发布一篇草稿请显式传 mode=publish。不要用它校正正文之外的东西(那要重新发布),也不要传空字段试图"清空"某个值——省略即保持原值。

get_articleA

按 id 读取一篇文章的完整记录(草稿也能读到),这是确认 status 原始状态码、判断草稿/审核/发布的权威口径。文章很长时传 include_content=false,只取元数据、不返回正文,避免把上下文挤爆。想浏览已发布文章列表用 list_articles;想验证一次写入是否真的生效用 verify_article。

list_articlesA

列出账号的文章。scope="published"(默认)走公开接口、不需要 Cookie,只含已发布文章;scope="all" 走作者后台接口、需要 Cookie,包含草稿,并在 counts 里给出 draft/publish 等分类计数——这是唯一能回答「我有哪些草稿」的口径(公开接口看不到草稿,get_article 又要先知道 id)。注意后台接口的每页条数由 CSDN 服务端固定,page_size 传入后可能被忽略,返回的 pageSize 是实际值。不要用它判断某篇文章是否发布成功——看不到不等于没发布,请用 verify_article。

verify_articleA

回查一篇文章的真实状态:CSDN 接口的 status + 公开页的 HTTP 码,两个信号都看,缺一不可(只看接口会漏判,只看公开页会把审核中误判成失败)。expected 省略时按当前状态推断。它是只读的,不会修改任何东西;也不是必须的步骤——publish_article / update_article 已经默认自检,重复调用只会多花两次请求。

delete_articleA

删除一篇文章,默认进回收站(permanent=false,可在创作中心的回收站里恢复)。只有确认文章永远不该存在时才传 permanent=true——那是彻底删除,无法恢复。不要用它清理草稿以外的临时状态,也不要因为"想改标题"而删除重建:元数据直接改 update_article 就行,只有误发布的文章才必须走"删除后重建"这条路。

upload_imageA

把本地图片上传到 CSDN 图床,返回公网 URL(正文里请写这个绝对 URL,CSDN 有防盗链)。kind 决定通道:封面图用 cover,正文图用 body,两条通道不通用。不要用它上传非图片文件(仅支持 jpg/jpeg/png/gif/webp/bmp);也不要拿返回的 key 当图片地址用,那不是公网地址。

list_categoriesA

列出可用于 publish_article / update_article 的 categories 字段的分类名。CSDN 接口不可用时会降级返回内置列表(source=builtin)而不是报错,所以拿到 builtin 时要知道那不是账号的真实分类:先确认接口可用,或直接在 CSDN 创作中心里核对分类名。它不返回分类 id,也不需要 Cookie 之外的任何参数。

list_tagsA

列出账号常用/推荐的标签,供 publish_article 的 tags 字段(每篇最多 5 个)挑选。接口不可用时会降级返回内置列表(source=builtin),那不是账号的真实标签,只是能用的候选。它不会创建标签,也不校验标签是否存在——CSDN 允许新标签,拼错的标签会原样出现在文章上。

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.7/5.0

Scored across 11 tools

Disambiguation5/5

Each tool targets a distinct action-resource pair: auth tools handle authentication state, article tools cover lifecycle (publish/update/get/list/delete/verify), and auxiliary tools handle images and metadata. Descriptions explicitly warn against common misuses (e.g., publish_article vs update_article), eliminating ambiguity.

Naming Consistency5/5

All tool names follow a consistent verb_noun snake_case pattern (auth_status, list_tags, publish_article, upload_image, etc.), with each verb clearly indicating the action. There is no mixing of conventions or vague verbs.

Tool Count5/5

11 tools is well within the ideal range for a domain-specific server, covering authentication, article CRUD, listing, verification, image upload, and metadata lookup without unnecessary bloat. Each tool earns its place in the workflow.

Completeness5/5

The tool set provides full lifecycle coverage for articles (create, read, update, delete, list, verify), plus image upload and metadata retrieval (tags/categories). Authentication is handled comprehensively. The only limitation is an inherent CSDN API constraint, not a missing tool.

Maintenance

ActivityMaintained
ResponsivenessNo issues