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 密钥

访问 Google Cloud 控制台
创建一个新的项目或选择一个现有项目
启用 Blogger v3 API
创建一个 API 密钥
记下这个密钥以用于配置

配置 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 上部署：

如果您还没有账户，请在 Vercel 上创建一个账户
安装 Vercel CLI 工具：npm install -g vercel
登录到您的 Vercel 账户：vercel login
配置您的环境变量秘密：vercel secrets add blogger_api_key "VOTRE_CLE_API_ICI"
部署项目：vercel

使用 Docker 进行部署

项目包含一个 Dockerfile 以便于在 Docker 容器中部署：

构建 Docker 镜像：
```
docker build -t blogger-mcp-server .
```

运行容器：

docker run -p 3000:3000 -e BLOGGER_API_KEY=您的_api密钥 blogger-mcp-server

其他部署选项

该服务器也可以部署到其他与 Node.js 兼容的平台上：

Heroku：使用 Procfile 和 Heroku 环境变量
AWS Lambda：使用如 Serverless Framework 的适配器
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 (添加新功能)