腾讯云开发者社区文章发布 MCP 服务器
📝 项目简介
这是一个基于 MCP (Model Context Protocol) 协议的服务器，专门用于自动化发布文章到腾讯云开发者社区。通过集成 Spring Boot 3.x 和 Spring AI，为 AI 助手提供了与腾讯云开发者社区交互的能力，实现文章的自动发布和管理。
技术栈
- 框架: Spring Boot 3.4.5
- AI 集成: Spring AI 1.0.0
- 运行环境: Java 17
- 构建工具: Maven
- 协议支持: MCP (Model Context Protocol)
- HTTP 客户端: Retrofit2
- JSON 处理: FastJSON, Jackson
快速开始
环境要求
- JDK 17 或更高版本
- Maven 3.6 或更高版本
- 有效的腾讯云开发者社区账号
安装步骤
- 克隆项目
git clone https://github.com/yangbuyiya/tencent-send-article-mcp-server.git
cd tencent-send-article-mcp-server- 获取腾讯云 Cookie
- 登录 腾讯云开发者社区 - 打开浏览器开发者工具 (F12) - 切换到 Network 标签页 - 刷新页面，在任意请求的 Headers 中找到 Cookie - 复制完整的 Cookie 字符串
- 配置认证信息
# 方式一：环境变量
export TENCENT_API_COOKIE="your_cookie_here"
# 方式二：命令行参数
java -jar target/tencent-send-article-mcp-server-app.jar --tencent.api.cookie="your_cookie_here"- 修改代码定义文章专栏
前往 getAddArticleRequest 方法中修改文章部分请求参数 具体参数前往 登录 腾讯云开发者社区 打开开发者工具, 发布一个测试文章选好你要发布的专栏等数据 找到 addArticle 请求复制出来, 将请求参数下面当中的参数替换即可
// 只允许修改下面的参数
addArticleRequest.setSourceType(1); // 设置为原创
addArticleRequest.setClassifyIds(List.of(3,4)); // 设置文章分类
addArticleRequest.setTagIds(List.of(17375)); // 设置文章标签
addArticleRequest.setLongtailTag(List.of("面试","面试题","趣味面试")); // 设置长尾标签
addArticleRequest.setColumnIds(List.of(105380)); // 设置专栏ID
addArticleRequest.setOpenComment(1); // 开启评论
addArticleRequest.setCloseTextLink(1); // 允许文本链接
addArticleRequest.setPic(""); // 设置封面图片
addArticleRequest.setSourceDetail(new HashMap<>()); // 设置来源详情
addArticleRequest.setZoneName(""); // 设置专区名称- 编译和运行
# 编译项目
mvn clean package配置说明
MCP 客户端配置 STDIO 模式
在您的 MCP 客户端配置文件中添加以下配置：
{
"mcpServers": {
"tencent-article-publisher": {
"command": "java",
"args": [
"-Dspring.ai.mcp.server.stdio=true",
"-Dfile.encoding=utf-8",
"-jar",
"/path/to/tencent-send-article-mcp-server-app.jar",
"--tencent.api.cookie=your_cookie_here"
]
}
}
}也可以调用 ClientStdio.java 类进行测试是否通信
MCP 客户端配置 SSE 模式
{
"mcpServers": {
"tencent-send-article-mcp-server": {
"baseUrl": "http://127.0.0.1:8633/sse"
}
}
}
项目默认使用 STDIO 模式，如果需要使用 SSE 模式，请按照以下配置进行修改：(项目已经区分配置, 可通过 profiles.active=sse/stdio 切换模式)
修改配置文件 - 新增端口
server:
port: 8633 # 端口号
修改配置文件 - 切换模式为SSE
ai:
mcp:
server:
stdio: true # 设置为false 为sse模式
name: ${spring.application.name}
version: 1.0.0
type: sync # 同步/异步
instructions: "
这是一个基于 MCP (Model Context Protocol) 协议的服务器，
专门用于自动化发布文章到腾讯云开发者社区。通过集成 Spring Boot 3.x 和 Spring AI，为 AI 助手提供了与腾讯云开发者社区交互的能力，
实现文章的自动发布和管理。
"
sse-endpoint: /sse # sse端点
sse-message-endpoint: /mcp/messages # 客户端 sse消息端点
capabilities:
tool: true
resource: true
prompt: true
completion: true修改配置文件 - 日志配置修改
# 注意：您必须禁用web横幅和控制台日志记录，以允许STDIO传输工作！！！
main:
banner-mode: off
# SSE打开, STDIO注释
web-application-type: none
logging:
# SSE打开, STDIO注释
pattern:
console: "%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"
file:
name: data/log/${spring.application.name}.log
修改 pom.xml - 新增SSE依赖支持
org.springframework.ai
spring-ai-starter-mcp-server-webflux
然后就可以调用 ClientSse.java 类进行测试是否通信
Docker 部署使用
快速部署
docker run -d --name tencent-send-article-mcp-server \
-p 8635:8633 \
-e TENCENT_API_COOKIE="测试Cookie" \
registry.cn-hangzhou.aliyuncs.com/yangbuyiya/tencent-send-article-mcp-server-app:1.0.0
构建镜像
⚠️先修改部署配置文件, 我这里以shell文件为例
# Docker镜像相关配置
DOCKER_IMAGE_NAME="改成你的DockerHub仓库名称/tencent-send-article-mcp-server-app"
DOCKER_IMAGE_TAG="1.0.0"
DOCKER_PLATFORM="linux/amd64,linux/arm64"
DOCKERFILE_PATH="Dockerfile"
# 阿里云配置
ALIYUN_REGISTRY="registry.cn-hangzhou.aliyuncs.com"
NAMESPACE="你的阿里云命名空间仓库名称"
IMAGE_NAME="tencent-send-article-mcp-server-app"
IMAGE_TAG="1.0.0"
修改完毕后, 运行 deploy 脚本进行构建, 构建完成后会生成镜像
运行
docker run -d --name tencent-send-article-mcp-server \
-p 8635:8633 \
-e TENCENT_API_COOKIE="你在腾讯云开发者社区获取的Cookie" \
registry.cn-hangzhou.aliyuncs.com/yangbuyiya/tencent-send-article-mcp-server-app:1.0.0
安全注意事项
⚠️ 重要提醒：
- Cookie 包含敏感的身份认证信息，请妥善保管
- 不要将 Cookie 提交到代码仓库或公开分享
- 建议使用环境变量方式配置 Cookie
- Cookie 可能会定期失效，需要及时更新
- 生产环境建议使用更安全的认证方式
故障排除
常见问题
- Cookie 失效
- 重新登录腾讯云开发者社区获取新的 Cookie - 检查 Cookie 格式是否完整
- 文章发布失败
- 检查网络连接 - 验证文章内容是否符合社区规范 - 确认账号权限
- MCP 连接问题
- 检查 Java 路径配置 - 验证 JAR 文件路径 - 查看应用日志文件
日志查看
# 查看实时日志
tail -f data/log/tencent-send-article-mcp-server.log
# 查看错误日志
grep "ERROR" data/log/tencent-send-article-mcp-server.log贡献指南
欢迎提交 Issue 和 Pull Request！
- Fork 本项目
- 创建特性分支 dev
- 提交更改
- 推送到分支
- 开启 Pull Request
注意：本项目仅用于学习和研究目的，请遵守腾讯云开发者社区的使用条款和相关法律法规。