内容
# 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 API v3
4. 创建一个API密钥
5. 记下此密钥以便在配置中使用
### MCP服务器配置
为您的MCP客户端创建一个配置文件。以下是Claude Desktop的示例:
```json
{
"mcpServers": {
"blogger": {
"command": "npx",
"args": [
"-y",
"@mcproadev/blogger-mcp-server"
],
"env": {
"BLOGGER_API_KEY": "您的_API_密钥_在这里"
}
}
}
}
```
将 `您的_API_密钥_在这里` 替换为您获得的API密钥。
## 使用
### 本地启动
该项目包含两个脚本,以便于启动服务器:
#### 开发模式
```bash
export BLOGGER_API_KEY=您的_api_密钥
./start-dev.sh
```
此脚本检查API密钥的存在,如果需要,安装依赖项,如果需要,编译项目,然后以开发模式启动服务器。
#### 生产模式
```bash
export BLOGGER_API_KEY=您的_api_密钥
npm run build
./start-prod.sh
```
此脚本检查API密钥的存在和项目是否已编译,然后以生产模式启动服务器。
### 与MCP客户端一起使用
配置完成后,您可以使用MCP服务器与任何兼容的MCP客户端(如Claude Desktop)进行交互。
命令示例:
* "列出我所有的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 "您的_API_密钥_在这里"`
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密钥进行身份验证,这限制了对公共博客或您明确配置访问权限的博客的访问。
## 贡献
欢迎贡献!请随时提出问题或提交拉取请求。
## 许可证
该项目采用MIT许可证。