MCP Server CSDN

基于 Spring AI MCP 协议的 CSDN 博客智能管理服务。通过 MCP（Model Context Protocol）标准协议，让 AI 大模型能够直接操作 CSDN 博客，实现文章的自动发布与管理。

技术架构

graph TB
    subgraph AI Layer
        LLM[大语言模型 / AI Agent]
    end

    subgraph MCP Server
        MCP[Spring AI MCP Server]
        TOOL[MCP Tool - 文章发布]
    end

    subgraph Infrastructure
        RETROFIT[Retrofit HTTP Client]
        OKHTTP[OkHttp3]
    end

    subgraph External
        CSDN[CSDN API Gateway]
    end

    LLM -->|MCP 协议 stdio| MCP
    MCP --> TOOL
    TOOL --> RETROFIT
    RETROFIT --> OKHTTP
    OKHTTP -->|HTTPS| CSDN

核心技术栈

| 技术 | 版本 | 说明 | |------|------|------| | Spring Boot | 3.4.3 | 应用框架 | | Spring AI MCP | 1.0.0-M6 | MCP 协议服务端实现 | | Retrofit | 2.9.0 | 声明式 HTTP 客户端 | | OkHttp3 | - | HTTP 底层通信 | | FastJSON | 2.0.28 | JSON 序列化 | | Flexmark | 0.64.8 | Markdown 解析与转换 | | Lombok | - | 代码简化 | | Java | 17 | 运行环境 |

功能特性

MCP 协议支持: 基于 Spring AI MCP Server，通过 stdio 传输与 AI 客户端通信
文章发布管理: 支持 Markdown 文章的自动发布到 CSDN 平台
Markdown 转 HTML: 集成 Flexmark 实现 Markdown 到 HTML 的自动转换
灵活的文章配置: 支持设置文章类型（原创/转载/翻译）、可见性、标签、分类等
DDD 分层架构: 采用领域驱动设计，清晰的代码组织结构

项目结构

src/main/java/cn/bugstack/mcp/server/csdn/
├── McpServerApplication.java          # 启动类，配置 Retrofit 和 OkHttp
├── domain/                            # 领域层
│   ├── adapter/                       # 适配器接口
│   ├── model/                         # 领域模型
│   └── service/                       # 领域服务
├── infrastructure/                    # 基础设施层
│   ├── adapter/                       # 适配器实现
│   └── gateway/                       # 外部网关
│       ├── ICSDNService.java          # CSDN API 接口定义 (Retrofit)
│       └── dto/                       # 数据传输对象
│           ├── SaveArticleRequestDTO.java
│           └── SaveArticleResponseDTO.java
└── type/                              # 通用类型定义

快速启动

环境要求

JDK 17+
Maven 3.8+

构建与运行

# 克隆项目
git clone https://github.com/cydmacro/mcp-server-csdn.git
cd mcp-server-csdn

# 编译打包
mvn clean package -DskipTests

# 运行（stdio 模式，供 MCP 客户端调用）
java -jar target/mcp-server-csdn-1.0.0.jar

配置 CSDN 认证

使用前需要配置 CSDN 平台的认证信息：

登录 CSDN 网站，通过浏览器开发者工具获取 Cookie
获取 API 网关签名所需的 x-ca-key
将认证信息通过环境变量或配置文件传入

export CSDN_COOKIE="your_csdn_cookie_here"

MCP 协议说明

本服务实现了 Model Context Protocol (MCP) 规范，作为 MCP Server 运行。

传输方式

采用 stdio 传输模式，通过标准输入输出与 MCP 客户端（如 Claude Desktop、Cursor 等）通信。

客户端配置示例

在 MCP 客户端中添加如下配置：

{
  "mcpServers": {
    "mcp-server-csdn": {
      "command": "java",
      "args": ["-jar", "/path/to/mcp-server-csdn-1.0.0.jar"],
      "env": {
        "CSDN_COOKIE": "your_csdn_cookie_here"
      }
    }
  }
}

提供的 MCP Tools

| Tool 名称 | 功能描述 | |-----------|---------| | saveArticle | 发布或保存 CSDN 博客文章 |

License

MIT

MCP Servers