# mcp仓库

**Repository Path**: hduzjn/mcp-warehouse

## Basic Information

- **Project Name**: mcp仓库
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-17
- **Last Updated**: 2026-01-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CSDN发帖服务 (mcp-csdn)

## 项目概述

这是一个基于Spring Boot和Retrofit的CSDN发帖服务，它提供了一个简洁的接口来发布文章和保存草稿到CSDN平台。该服务遵循MCP（Micro Content Platform）架构设计，将业务逻辑和基础设施关注点分离，提供了清晰的分层结构。

## 架构设计

该项目采用了经典的分层架构，包括：

1. **应用层（Application Layer）**：提供对外的服务接口，处理请求验证、日志记录等应用级逻辑
2. **领域层（Domain Layer）**：包含核心业务逻辑，定义了服务接口和实现
3. **基础设施层（Infrastructure Layer）**：负责与外部系统的交互，如CSDN API的调用

### 主要组件

- `CsdnPostApplicationService`：应用服务，作为外部调用入口
- `CsdnPostService`：领域服务接口，定义核心业务功能
- `CsdnPostServiceImpl`：领域服务实现，封装业务逻辑
- `ICSDNService`：基础设施服务，使用Retrofit调用CSDN API

## 快速开始

### 前提条件

- JDK 17或更高版本
- Maven 3.6或更高版本
- 有效的CSDN登录Cookie

### 构建项目

```bash
mvn clean package
```

### 运行示例应用

1. 修改`ExampleApplication.java`中的Cookie值为你的CSDN登录Cookie
2. 运行应用：

```bash
java -jar target/mcp-csdn-1.0-SNAPSHOT.jar
```

### 使用服务

```java
// 获取服务实例
CsdnPostApplicationService csdnPostService = context.getBean(CsdnPostApplicationService.class);

// 保存草稿
SaveArticleResponseDTO draftResponse = csdnPostService.saveDraft(
        cookie, title, content, markdownContent, tags);

// 发布文章
SaveArticleResponseDTO publishResponse = csdnPostService.publishArticle(
        cookie, title, content, markdownContent, tags);
```

## API文档

### CsdnPostApplicationService

#### 保存草稿
```java
SaveArticleResponseDTO saveDraft(
        String cookie,        // CSDN登录Cookie
        String title,         // 文章标题
        String content,       // 文章内容（HTML格式）
        String markdownContent, // 文章内容（Markdown格式）
        String tags           // 文章标签，逗号分隔
) throws Exception
```

#### 发布文章
```java
SaveArticleResponseDTO publishArticle(
        String cookie,        // CSDN登录Cookie
        String title,         // 文章标题
        String content,       // 文章内容（HTML格式）
        String markdownContent, // 文章内容（Markdown格式）
        String tags           // 文章标签，逗号分隔
) throws Exception
```

## 注意事项

1. 使用该服务需要有效的CSDN登录Cookie，你可以从浏览器的开发者工具中获取
2. 发布文章功能会在CSDN上发布真实文章，请谨慎使用
3. 保存草稿功能不会公开文章，适合测试使用
4. 建议在生产环境中使用配置文件或环境变量来存储敏感信息如Cookie

## 许可证

MIT License