使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它提供了一个用于生成企业品牌声音博客文章的后端服务。通过集成 MCP 协议，该服务器能够以标准化的方式与支持 MCP 协议的客户端（如LLM应用）进行交互，提供博客文章生成功能。

主要功能点

MCP协议支持: 实现了 MCP 服务器的核心功能，可以通过 JSON-RPC 协议与客户端通信，接收工具调用请求并返回结果。
品牌声音定制: 支持多种品牌声音风格（例如技术型、对话型、思想领导型），允许用户根据需求定制生成的博客文章的语 Tone 和风格。
SEO优化: 生成的博客文章内容考虑了搜索引擎优化 (SEO)，有助于提升文章在搜索结果中的排名。
自动化博客生成: 用户只需提供公司名称、公司网站和博客标题等信息，服务器即可自动完成研究、内容分析、文章撰写等流程，生成高质量的博客文章。
工具化调用: 通过 MCP 协议将博客文章生成功能封装为工具 (Tool)，方便 LLM 应用或其他 MCP 客户端进行调用和集成。

安装步骤

克隆仓库

git clone https://github.com/Virul360/brand-voice-blog-post-mcp.git
cd brand-voice-blog-post-mcp

安装依赖

pip install -r requirements.txt

配置 Gemini API 密钥
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加以下内容，并将 'your-api-key-here' 替换为你的 Gemini API 密钥。
```
GEMINI_API_KEY=your-api-key-here
```
- 或者，你也可以通过设置环境变量 'GEMINI_API_KEY' 来提供 API 密钥。

服务器配置

以下 JSON 配置信息描述了如何配置一个 MCP 客户端以连接到此 MCP 服务器。客户端需要配置服务器的启动命令及其参数。

{
  "serverName": "brand-voice-blog-post-mcp-server",
  "command": "python",
  "args": [
    "-m",
    "blog_post_agent",
    "mcp"
  ],
  "description": "Brand Voice Blog Post Generator MCP Server"
}

配置参数说明:

'serverName': 服务器的名称，可以自定义，用于在客户端中标识该服务器。例如: "brand-voice-blog-post-mcp-server"。
'command': 启动服务器的命令。由于服务器代码是 Python 编写的，这里设置为 "python"。
'args': 启动服务器命令的参数，以列表形式提供。
- '"-m"': Python 的 '-m' 参数用于以模块名运行库模块。
- '"blog_post_agent"': 指定要运行的模块名为 'blog_post_agent'，对应仓库中的 'blog_post_agent' 目录。
- '"mcp"': 指定运行 'blog_post_agent' 模块的 'mcp' 子命令，用于启动 MCP 服务器模式。
'description': 服务器的描述信息，用于帮助用户理解服务器的用途。例如: "Brand Voice Blog Post Generator MCP Server"。

注意: MCP 客户端需要能够执行 'python' 命令，并且 Python 环境中已安装好该 MCP 服务器及其依赖。客户端通过标准输入/输出 (stdio) 与 MCP 服务器进行通信。

基本使用方法

启动 MCP 服务器 在项目根目录下，打开终端并执行以下命令启动 MCP 服务器：
```
python -m blog_post_agent mcp
```
服务器成功启动后，会监听来自 MCP 客户端的请求。

使用 MCP 客户端调用工具 配置好 MCP 客户端后，客户端可以向服务器发送 JSON-RPC 请求，调用名为 'generate_blog_post' 的工具 (Tool) 来生成博客文章。

调用 'generate_blog_post' 工具时，需要提供以下参数：

'company_name': 要为其生成博客文章的公司名称。（字符串类型）
'company_website': 公司的官方网站 URL。（字符串类型）
'blog_title': 要生成的博客文章的标题。（字符串类型）

例如，客户端可以发送如下 JSON-RPC 请求 (假设使用 JSON-RPC over stdio 协议):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "tool_name": "generate_blog_post",
    "arguments": {
      "company_name": "Example Company",
      "company_website": "https://example-company.com",
      "blog_title": "The Future of AI in Marketing"
    }
  },
  "id": 1
}

服务器收到请求后，会执行博客文章生成流程，并通过 JSON-RPC 响应将生成的博客文章内容返回给客户端。返回结果会包含生成的博客文章文本以及相关的元数据信息。

总结: 此仓库提供了一个基于 MCP 协议的博客文章生成服务器，允许 MCP 客户端通过调用 'generate_blog_post' 工具，并提供必要的公司和文章信息，即可自动化生成品牌声音定制的 SEO 优化博客文章。

关键词