blogger-mcp-server

=======

Blogger 的 MCP 服务器

一个 MCP（Model Context Protocol）服务器，允许像 Claude 这样的人工智能模型直接与 Google 的 Blogger API 交互。

关于

该项目实现了与 Google 的 Blogger API 兼容的 MCP（Model Context Protocol）服务器。它允许像 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 v3 API
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 客户端一起使用

一旦配置完成，您可以使用任何兼容的 MCP 客户端（如 Claude Desktop）来使用 Blogger 的 MCP 服务器。

命令示例：

• "列出我所有的 Blogger 博客"
• "在我的 ID 为 123456 的博客上创建一个标题为 '我的新文章' 和内容为 '这是我的文章内容' 的新文章"
• "在我的博客中搜索包含 '技术' 一词的文章"
• "将 ID 为 789012 的文章标题更改为 '新标题'"

部署选项

在 Vercel 上部署

项目包括一个 vercel.json 文件，以便于在 Vercel 上部署：

1. 如果您还没有账户，请在 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=您的_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 的网页界面手动创建。
• 搜索文章：Blogger API 没有直接提供搜索功能的端点。此功能是在客户端实现的，通过获取所有文章然后进行过滤。
• 标签管理：Blogger API 没有直接提供的用于管理标签的端点。此功能是通过从文章中提取标签来实现的。
• 认证：此服务器仅使用 API 密钥认证，这限制了访问公开博客或您已明确配置访问权限的博客。

贡献

欢迎贡献！请随时打开 issue 或 pull request。

许可证

本项目采用 MIT 许可证。

cf72ca4 (添加新功能)