AI导哈

博客API服务

一个基于MCP协议的服务器，允许AI模型如Claude直接与Google Blogger API交互，实现博客内容的创建、更新、删除等操作。

  • by niyonabil
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 niyonabil/blogger-mcp-server

使用说明

博客mcp服务器

=======

Blogger的MCP服务器

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

关于

该项目实现了一个与Google Blogger API的模型上下文协议（MCP）兼容的服务器。它允许像Claude这样的人工智能模型与Blogger博客进行交互，以便：

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

重要事项 ：Google Blogger API不允许通过API创建新博客。谷歌记录了这一限制。博客必须通过Blogger的web界面手动创建。

Prérequis

  • 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. 访问 控制台谷歌云
  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客户端一起使用

配置后，您可以使用MCP服务器与任何兼容的MCP客户端（如Claude Desktop）进行博客。

订单示例：

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

部署选项

在Vercel上部署

该项目包括一个文件 vercel.json 为了便于在Vercel上部署：

  1. 在上创建帐户 维塞尔 如果你还没有
  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 ：使用适配器，如无服务器框架
  3. 谷歌云运行 ：使用附带的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密钥身份验证，这限制了对公共博客或您明确配置访问权限的博客的访问。

贡献

欢迎捐款！不要犹豫打开问题或拉取请求。

许可证

该项目获得MIT许可。

CF72CA4（新增功能）

相关 MCP