blogger-mcp-server

blogger-mcp-server

镜子 (jìng zi)

MCP-Mirror

开发者工具
访问服务器

README

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 (添加了新功能)

推荐服务器

Playwright MCP Server

Playwright MCP Server

一个模型上下文协议服务器,它使大型语言模型能够通过结构化的可访问性快照与网页进行交互,而无需视觉模型或屏幕截图。

官方
精选
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

一个由人工智能驱动的工具,可以从自然语言描述生成现代化的用户界面组件,并与流行的集成开发环境(IDE)集成,从而简化用户界面开发流程。

官方
精选
本地
TypeScript
MCP Package Docs Server

MCP Package Docs Server

促进大型语言模型高效访问和获取 Go、Python 和 NPM 包的结构化文档,通过多语言支持和性能优化来增强软件开发。

精选
本地
TypeScript
Claude Code MCP

Claude Code MCP

一个实现了 Claude Code 作为模型上下文协议(Model Context Protocol, MCP)服务器的方案,它可以通过标准化的 MCP 接口来使用 Claude 的软件工程能力(代码生成、编辑、审查和文件操作)。

精选
本地
JavaScript
@kazuph/mcp-taskmanager

@kazuph/mcp-taskmanager

用于任务管理的模型上下文协议服务器。它允许 Claude Desktop(或任何 MCP 客户端)在基于队列的系统中管理和执行任务。

精选
本地
JavaScript
mermaid-mcp-server

mermaid-mcp-server

一个模型上下文协议 (MCP) 服务器,用于将 Mermaid 图表转换为 PNG 图像。

精选
JavaScript
Jira-Context-MCP

Jira-Context-MCP

MCP 服务器向 AI 编码助手(如 Cursor)提供 Jira 工单信息。

精选
TypeScript
Linear MCP Server

Linear MCP Server

一个模型上下文协议(Model Context Protocol)服务器,它与 Linear 的问题跟踪系统集成,允许大型语言模型(LLM)通过自然语言交互来创建、更新、搜索和评论 Linear 问题。

精选
JavaScript
Sequential Thinking MCP Server

Sequential Thinking MCP Server

这个服务器通过将复杂问题分解为顺序步骤来促进结构化的问题解决,支持修订,并通过完整的 MCP 集成来实现多条解决方案路径。

精选
Python
Curri MCP Server

Curri MCP Server

通过管理文本笔记、提供笔记创建工具以及使用结构化提示生成摘要,从而实现与 Curri API 的交互。

官方
本地
JavaScript