# Blogger AI 中介
## 基本信息
- Slug: `niyonabil-blogger-mcp-server`
- Source: modelscope
- Publisher: @niyonabil/blogger-mcp-server
- Categories: communication / social-media
- Hosted: No
- License: Unknown
- Source URL: https://www.modelscope.cn/mcp/servers/@niyonabil/blogger-mcp-server
## 简介
一个中间服务器， enables 人工智能模型与谷歌的Blogger平台交互，通过Blogger API自动创建和管理博客、帖子和标签。 （注：原文中的“enables”在翻译成中文时需根据上下文调整词性或结构以使句子通顺，这里为了保持与原文结构的一致性，暂时保留了类似的表达方式。更流畅的翻译可以是：） 一个中间服务器，使人工智能模型能够与谷歌的Blogger平台交互，通过Blogger API自动创建和管理博客、帖子和标签。
## 安装提示

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

## MCP Server 详情

# 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 安装

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


### 从源代码安装

```bash
git clone https://github.com/niyonabil/blogger-mcp-server.git
cd blogger-mcp-server
npm install
npm run build
```
如果遇到错误，请执行：

```bash
npm install --save-dev @types/express @types/socket.io
```
## 配置

### 获取 Blogger API 密钥

1. 访问 [Google Cloud 控制台](https://console.cloud.google.com/)
2. 创建一个新的项目或选择一个现有项目
3. 启用 Blogger v3 API
4. 创建一个 API 密钥
5. 记下这个密钥以用于配置

### 配置 MCP 服务器

为您的 MCP 客户端创建一个配置文件。以下是针对 Claude Desktop 的示例：

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


将 `VOTRE_CLE_API_ICI` 替换为您获得的 API 密钥。

## 使用

### 本地启动

项目包括两个脚本来简化服务器的启动过程：

#### 开发模式

```bash
export BLOGGER_API_KEY=votre_cle_api
./start-dev.sh
```


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

#### 生产模式

```bash
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](https://vercel.com/) 上创建一个账户
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 镜像：
   ```bash
   docker build -t blogger-mcp-server .
   ```

2. 运行容器：
   ```bash
   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 (添加新功能)

