blogger-mcp-server

blogger-mcp-server

=======

Blogger MCP 服务

一个 MCP（Model Context Protocol）服务，可让 Claude 等人工智能模型直接与 Google Blogger API 交互。

关于

本项目实现了一个兼容 MCP（Model Context Protocol）协议的 Google Blogger API 服务。它可让 Claude 等 AI 模型与 Blogger 博客交互，以便：

• 列出并获取博客
• 列出、搜索、获取、创建、更新和删除帖子
• 列出并获取标签

重要提示：Google Blogger API 不支持通过 API 创建新博客。Google 已记录此限制。必须通过 Blogger 网页界面手动创建博客。

前提条件

• Node.js（版本 16 或更高）
• Google Blogger API 密钥

安装

通过 npm 安装

npm install -g @mcproadev/blogger-mcp-server

从源代码安装

git clone https://github.com/niyonabil/blogger-mcp-server.git
cd blogger-mcp-server
npm install
npm run build

如果安装出错：

npm install --save-dev @types/express @types/socket.io

配置

获取 Blogger API 密钥

1. 访问 Google Cloud 控制台
2. 创建新项目或选择现有项目
3. 启用 Blogger API v3
4. 创建 API 密钥
5. 记下此密钥，以便在配置中使用

配置 MCP 服务

为你的 MCP 客户端创建配置文件。以下是 Claude Desktop 的配置示例：

{
  "mcpServers": {
    "blogger": {
      "command": "npx",
      "args": [
        "-y",
        "@mcproadev/blogger-mcp-server"
      ],
      "env": {
        "BLOGGER_API_KEY": "VOTRE_CLE_API_ICI"
      }
    }
  }
}

将 VOTRE_CLE_API_ICI 替换为你获取的 API 密钥。

使用

本地启动

本项目包含两个脚本，可便于启动服务：

开发模式

export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh

此脚本会检查 API 密钥是否存在，必要时安装依赖项并编译项目，然后以开发模式启动服务。

生产模式

export BLOGGER_API_KEY=votre_cle_api
npm run build
./start-prod.sh

此脚本会检查 API 密钥是否存在以及项目是否已编译，然后以生产模式启动服务。

与 MCP 客户端搭配使用

配置完成后，你可以将 Blogger MCP 服务与任何兼容的 MCP 客户端搭配使用，例如 Claude Desktop。

命令示例：

*“列出我所有的 Blogger 博客” *“在 ID 为 123456 的博客中创建一篇新帖子，标题为‘我的新帖子’，内容为‘这是我的帖子内容’” *“在我的博客中搜索包含‘技术’一词的帖子” *“更新 ID 为 789012 的帖子，将标题改为‘新标题’”

部署选项

部署到 Vercel

本项目包含 vercel.json 文件，可便于部署到 Vercel：

1. 如果你还没有 Vercel 账号，请在 Vercel 注册
2. 安装 Vercel CLI 工具：npm install -g vercel
3. 登录 Vercel 账号：vercel login
4. 配置机密环境变量：vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
5. 部署项目：vercel

使用 Docker 部署

本项目包含 Dockerfile，可便于在 Docker 容器中部署：

1. 构建 Docker 镜像：

   docker build -t blogger-mcp-server .
   

2. 运行容器：

   docker run -p 3000:3000 -e BLOGGER_API_KEY=votre_cle_api blogger-mcp-server
   

其他部署选项

此服务还可以部署到其他兼容 Node.js 的平台：

1. Heroku：使用 Procfile 和 Heroku 环境变量
2. AWS Lambda：使用 Serverless Framework 等适配器
3. Google Cloud Run：使用随附的 Dockerfile

项目结构

Blogger MCP 服务由多个模块组成：

• index.ts：主入口点
• server.ts：MCP 服务配置
• bloggerService.ts：与 Blogger API 交互的服务
• config.ts：服务配置
• types.ts：类型和接口定义
• mcp-sdk-mock.ts：MCP SDK 的简化实现，用于避免依赖项问题

已知限制

• 创建博客：Google 的 Blogger API 不允许通过 API 创建新博客。必须通过 Blogger 的 Web 界面手动创建博客。
• 搜索帖子：Blogger API 未提供直接用于搜索的 endpoint。此功能通过获取帖子并在客户端进行筛选来实现。
• 标签管理：Blogger API 未提供直接用于管理标签的 endpoint。此功能通过从帖子中提取标签来实现。
• 身份验证：此服务仅使用 API 密钥身份验证，因此只能访问公开博客或您已明确配置访问权限的博客。

贡献

欢迎贡献！欢迎提交 issue 或 pull request。

许可证

本项目采用 MIT 许可证。

cf72ca4 (添加新功能)