MCP 服务器

Docswrite MCP

将生成的内容导入 Google Docs，然后再导入 WordPress，同时保留格式和结构，以实现简化的内容工作流程。

README

Docswrite MCP 服务器

Docswrite 创建了世界上第一个 MCP，用于写入 Google Docs 并将 Google Docs 转换为 WordPress 上格式完美的文章。

此服务器通过 Docswrite 提供用于处理 Google Docs、Google Drive 和 WordPress 的工具。

工具

1. Google Docs & Drive 工具

`google-docs-create`

创建一个新的 Google Docs 文档。

title: 新文档的标题
content: 要写入文档的内容

`google-docs-update`

更新现有的 Google Docs 文档。

documentId: 要更新的文档的 ID
content: 要写入文档的内容
replaceAll (可选): 是否替换所有内容 (true) 或追加 (false)

`google-docs-search`

使用 Google Drive API 搜索 Google Docs 文档。

query: 用于查找文档的搜索查询
返回: 包含 ID、名称、创建时间和上次修改时间的文档列表

`google-docs-delete`

使用 Google Drive API 删除 Google Docs 文档。

documentId: 要删除的文档的 ID

2. Docswrite 工具

`docswrite-publish`

将 Google Docs 中的内容发布到 WordPress。

google_docs_url (必需): Google Docs 文档的 URL
title (可选): 博客文章的标题
slug (可选): 文章的 URL 别名
tags (可选): 逗号分隔的标签列表
categories (可选): 逗号分隔的分类目录列表
state (可选): 文章状态 (draft/publish)
author (可选): 作者姓名
date (可选): 发布日期
excerpt (可选): 文章摘要
post_type (可选): 文章类型 (post/page)
featured_image_url (可选): 专题图片的 URL
featured_image_alt_text (可选): 专题图片的替代文本
featured_image_caption (可选): 专题图片的标题
export_settings (可选): 包含以下内容的对象：
- compress_images: 布尔值
- demote_headings: 布尔值
- convert_to_webp: 布尔值
- first_image_as_featured_image: 布尔值
- add_no_follow_to_external_links: 布尔值
- bold_as_strong: 布尔值
- wp_content_editor: 字符串
newspack_settings (可选): 包含以下内容的对象：
- newspack_article_summary: 字符串
- newspack_article_summary_title: 字符串
- newspack_post_subtitle: 字符串
yoast_settings (可选): 包含以下内容的对象：
- yoast_focuskw: 字符串
- yoast_metadesc: 字符串
- yoast_title: 字符串
rankmath_settings (可选): 包含以下内容的对象：
- rank_math_focus_keyword: 字符串

`docswrite-job-status`

检查 Docswrite 发布作业的状态。

jobId: 要检查的作业的 ID
queueType (可选): 队列的类型 (默认: "post")

项目结构

源文件

src/index.ts: 主要服务器实现和工具定义
- 初始化 MCP 服务器
- 定义和注册所有可用的工具
- 处理命令行参数和环境变量
src/auth.ts: Google OAuth2 身份验证处理
- 管理 Google API 的 OAuth2 流程
- 处理令牌存储和刷新
- 为 Google Docs 和 Drive API 提供授权
src/google-docs.ts: Google Docs 和 Drive API 操作
- 文档创建和操作
- 内容更新和格式化
- 文档搜索和删除
- 错误处理和响应格式化
src/docswrite-request.ts: Docswrite API 集成
- 处理对 Docswrite 服务的请求
- 管理 WordPress 发布队列
- 作业状态检查和监控
src/oauth-server.ts: OAuth 回调服务器实现
- 处理来自 Google 的 OAuth2 回调
- 管理令牌交换
- 提供成功/失败响应
src/config.ts: 配置管理
- 环境变量
- API 端点
- 默认设置
src/utils.ts: 实用程序函数
- 辅助方法
- 常用操作
- 共享类型和接口

设置

创建一个 Google Cloud 项目并启用：
- Google Docs API
- Google Drive API
配置 OAuth2 凭据：
- 在 Google Cloud Console 中创建 OAuth2 凭据
- 下载并另存为项目根目录中的 credentials.json
- 将重定向 URI 设置为 http://localhost:3000/oauth2callback
安装依赖项：

npm install

构建项目：

npm run build

用法

使用您的 Docswrite 令牌运行服务器：

node dist/index.js --docswriteToken=your-docswrite-token

示例流程

1. 创建和发布流程

// 1. 创建一个新的 Google Doc
{
  "title": "我的新文章",
  "content": "这是我的文章的内容。"
}

// 2. 发布到 WordPress
{
  "google_docs_url": "https://docs.google.com/document/d/your-doc-id/edit",
  "title": "我的新文章",
  "state": "draft"
}

// 3. 检查发布状态
{
  "jobId": "your-job-id"
}

2. 搜索和更新流程

// 1. 搜索文档
{
  "query": "WordPress"
}

// 2. 更新文档
{
  "documentId": "your-doc-id",
  "content": "更新的内容",
  "replaceAll": true
}

3. 文档管理流程

// 1. 创建文档
{
  "title": "草稿文章",
  "content": "初始草稿"
}

// 2. 更新内容
{
  "documentId": "your-doc-id",
  "content": "附加内容",
  "replaceAll": false
}

// 3. 发布到 WordPress
{
  "google_docs_url": "https://docs.google.com/document/d/your-doc-id/edit",
  "title": "最终文章",
  "state": "publish",
  "categories": "tutorials",
  "tags": "wordpress, google-docs"
}