项目简介

本项目是一个基于 Model Context Protocol (MCP) 协议的服务器，专门用于自动化发布文章到腾讯云开发者社区。通过集成 Spring Boot 和 Spring AI，为 AI 助手提供了与腾讯云开发者社区交互的能力，实现文章的自动发布和管理。

主要功能点

• 文章发布: 允许通过 MCP 协议接收文章信息（标题、内容、摘要）并自动发布到指定的腾讯云开发者社区专栏。
• 工具集成: 将文章发布功能封装为 MCP Tool，可被支持 MCP 协议的 LLM 客户端调用。
• 认证支持: 通过配置腾讯云开发者社区的 Cookie 进行身份认证。
• 多传输协议: 支持通过 StdIo 和 SSE 两种方式与 MCP 客户端通信。

安装步骤

1. 克隆项目: 使用 Git 命令将项目仓库克隆到本地。
2. 获取腾讯云 Cookie: 登录腾讯云开发者社区，打开浏览器开发者工具，在网络请求中找到并复制您的认证 Cookie 字符串。
3. 配置认证信息: 将获取到的 Cookie 设置为环境变量 'TENCENT_API_COOKIE'，或者作为命令行参数 '--tencent.api.cookie=your_cookie_here' 传递给应用程序。
4. 修改代码定义文章专栏: 根据您的需求，修改项目代码中 'TencentArticleToolService.java' 文件里的 'getAddArticleRequest' 方法，设置文章的分类、标签、专栏 ID、封面图等默认参数。
5. 编译项目: 使用 Maven 构建工具编译项目，生成可执行的 JAR 文件。

服务器配置 (供 MCP 客户端参考)

要让您的 MCP 客户端连接到此服务器，您需要在客户端配置中指定服务器的启动方式。配置通常采用 JSON 格式，包含服务器名称、启动命令和参数等信息。

• Stdio 模式: 客户端需要配置启动服务器的 'command' 和 'args'。'command' 通常是 'java'，'args' 包含 '-jar' 指定服务器 JAR 文件的路径，以及必要的 Spring Boot 参数（如 '-Dspring.ai.mcp.server.stdio=true'）和用于传递腾讯云 Cookie 的参数（如 '--tencent.api.cookie=your_cookie_here'）。确保指定正确的文件编码 '-Dfile.encoding=utf-8'。
• SSE 模式: 客户端需要配置服务器的 'baseUrl'。服务器需要在配置中启用 SSE 模式（例如通过 Spring Boot Profile 或配置属性 'spring.ai.mcp.server.stdio=false' 并配置端口 'server.port' 及 SSE 端点 'spring.ai.mcp.server.sse-endpoint'）。客户端的 'baseUrl' 应指向服务器运行的地址和端口，例如 'http://127.0.0.1:8633/sse'。

具体的客户端配置语法请参考您使用的 MCP 客户端的文档。

基本使用方法

一旦 MCP 客户端与服务器建立连接，LLM 或客户端应用即可发现和调用服务器提供的工具。

1. 列出可用工具: 客户端可以调用 MCP 协议的 'listTools' 方法，服务器会返回其支持的工具列表，包括 'saveArticle' 和 'getArticleList' 工具及其描述。
2. 调用工具:
   • 调用 'saveArticle' 工具，向服务器发送包含 'title' (文章标题), 'markdowncontent' (Markdown 格式的文章内容), 'userSummary' (文章摘要) 参数的请求。
   • 服务器接收请求后，会使用配置的 Cookie 和预设的专栏/标签等信息，将文章发布到腾讯云开发者社区。
   • 服务器将发布结果以 'ArticleFunctionResponse' 格式返回给客户端，包含发布状态、文章 ID 和文章链接。
   • （注：'getArticleList' 工具在当前版本中标记为功能暂未实现，调用可能返回默认信息。）

请确保您的 MCP 客户端能够正确构造和解析 JSON-RPC 请求及响应。