blogger-mcp-server

=======

Blogger 的 MCP 服务器

一个 MCP (模型上下文协议) 服务器，允许像 Claude 这样的人工智能模型直接与 Google Blogger API 交互。

关于

此项目实现了一个与 Google Blogger API 兼容的 MCP (模型上下文协议) 服务器。它允许像 Claude 这样的 AI 模型与 Blogger 博客进行交互，以实现以下功能：

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

重要提示：Google Blogger API 不允许通过 API 创建新博客。此限制由 Google 记录在案。博客必须通过 Blogger 的 Web 界面手动创建。

前提条件

• 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 Console
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": "您的_API_密钥_在此处"
      }
    }
  }
}

将 您的_API_密钥_在此处 替换为您获得的 API 密钥。

使用

本地启动

该项目包含两个脚本，以方便启动服务器：

开发模式

export BLOGGER_API_KEY=您的_API_密钥
./start-dev.sh

此脚本检查 API 密钥是否存在，如果需要则安装依赖项，如果需要则编译项目，然后以开发模式启动服务器。

生产模式

export BLOGGER_API_KEY=您的_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 上创建一个帐户
2. 安装 Vercel CLI 工具：npm install -g vercel
3. 登录到您的 Vercel 帐户：vercel login
4. 配置您的秘密环境变量：vercel secrets add blogger_api_key "您的_API_密钥_在此处"
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 的 Web 界面手动创建。
• 搜索帖子：Blogger API 没有提供直接搜索的端点。此功能在客户端实现，通过检索帖子然后过滤它们。
• 管理标签：Blogger API 没有提供直接管理标签的端点。此功能通过从帖子中提取标签来实现。
• 身份验证：此服务器仅使用 API 密钥身份验证，这限制了对公共博客或您已明确配置访问权限的博客的访问。

贡献

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

许可证

此项目在 MIT 许可证下发布。

cf72ca4 (添加了新功能)