Servidor MCP de Google Docs

Este proyecto proporciona un servidor MCP (Protocolo de contexto de modelo) que funciona con la API de Google Docs. Estamos implementando una interfaz para manipular Google Docs utilizando IA generativa.

función

Este servidor MCP ofrece las siguientes características:

Leer documentos de Google Docs
Crear un nuevo documento de Google Docs
Cómo actualizar un documento existente de Google Docs
Cómo buscar documentos de Google Docs

Pila de tecnología

Node.js (se recomienda v14 o superior)
Mecanografiado
@modelcontextprotocol/sdk - Implementación oficial del SDK de MCP
Cliente Node.js de las API de Google : acceso a las API de Google

Prerrequisitos

Node.js (se recomienda v14 o superior)
npm o hilo
Proyecto de Google Cloud Platform y credenciales de acceso

configuración

1. Clonar o descargar el proyecto

git clone [リポジトリURL]
cd docs-mcp

2. Instalar dependencias

npm install

3. Configuración de Google Cloud Platform

Crea un proyecto en Google Cloud Console (o elige un proyecto existente)
Habilitar la API de Google Drive y la API de Google Docs
Cree un ID de cliente OAuth 2.0 y descargue las credenciales
Coloque el archivo de credenciales descargado como credentials.json en la raíz del proyecto.

4. Preferencias

Cree un archivo .env en la raíz de su proyecto y configure allí sus variables de entorno:

# アプリケーション環境
NODE_ENV=development

# ログ設定
# ログレベル: ERROR, WARN, INFO, DEBUG, TRACE
LOG_LEVEL=INFO
# 標準エラー出力にログを出力するかどうか（MCPの仕様に準拠）
LOG_USE_STDERR=true

# サーバー設定
SERVER_NAME=google-docs-mcp-server
SERVER_VERSION=1.0.0

# Google API認証情報
# 認証情報ファイルのパス（デフォルトは./credentials.json）
CREDENTIALS_PATH=./credentials.json
# トークンファイルのパス（デフォルトは./token.json）
TOKEN_PATH=./token.json

Explicación de las variables de entorno:

NODE_ENV : El entorno de ejecución de la aplicación (desarrollo, producción, prueba)
LOG_LEVEL : Nivel de detalle del registro (ERROR, WARN, INFO, DEBUG, TRACE)
LOG_USE_STDERR : si se deben enviar los registros a la salida de error estándar (la especificación MCP utiliza la salida de error estándar)
SERVER_NAME : Nombre del servidor MCP
SERVER_VERSION : Versión del servidor MCP
CREDENTIALS_PATH : Ruta al archivo de credenciales de la API de Google
TOKEN_PATH : Ruta para almacenar el token de autenticación

Inicie el servidor de desarrollo y obtenga un token:
npm run dev
Después de la ejecución, la URL de autorización se mostrará en la terminal. Accede a esa URL en tu navegador, inicia sesión con tu cuenta de Google y realiza la autorización. Una vez completada la autorización, copie el código de autorización que se muestra, péguelo en la terminal y presione Enter. Esto generará un archivo token.json y lo autenticará automáticamente a partir de ese momento.

Construir y ejecutar

Construir

npm run build

ejecución

Ejecutar como un servidor normal:

npm start

Ejecutándose en modo de desarrollo:

npm run dev

Úselo como servidor MCP

Este proyecto es un servidor que cumple con la especificación del Protocolo de Contexto de Modelo (MCP). Puede conectarse directamente desde los clientes MCP (Cursor, Claude.ai, etc.).

Configuración en el cliente MCP

Configuración con cursor

Para usarlo con Cursor, agregue la siguiente configuración a .cursor/mcp.json :

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": ["/{プロジェクトへの絶対パス}/docs-mcp/dist/index.js"]
    }
  }
}

Otros clientes de MCP

Otros clientes MCP se comunican utilizando entrada/salida estándar (stdio). Especifique el comando apropiado según la configuración de su cliente.

Herramientas MCP proporcionadas

leer_documento_de_google

Leer el contenido de un documento de Google Docs.

Parámetros :

documentId (cadena): el ID del documento de Google Docs que se leerá.

Ejemplo de uso :

// MCPクライアントでの使用例
const response = await client.callTool({
  name: "read_google_document",
  arguments: {
    documentId: "your-document-id"
  }
});

crear_documento_de_google

Crea un nuevo documento de Google Docs.

Parámetros :

title (cadena): el título del nuevo documento.
content (cadena, opcional): el contenido inicial del documento.

Ejemplo de uso :

const response = await client.callTool({
  name: "create_google_document",
  arguments: {
    title: "ドキュメントタイトル",
    content: "初期コンテンツ"
  }
});

actualizar_documento_de_google

Actualizar un documento de Google Docs existente.

Parámetros :

documentId (cadena): el ID del documento de Google Docs que se actualizará.
content (cadena): el contenido que se agregará o actualizará.
startPosition (número, opcional): la posición para comenzar a actualizar.
endPosition (número, opcional): la posición donde finalizar la actualización.

Ejemplo de uso :

const response = await client.callTool({
  name: "update_google_document",
  arguments: {
    documentId: "your-document-id",
    content: "追加または更新するコンテンツ",
    startPosition: 1,
    endPosition: 10
  }
});

buscar_documentos_de_google

Busque el documento de Google Docs.

Parámetros :

query (cadena): La consulta de búsqueda.
maxResults (número, opcional): el número máximo de resultados a recuperar (predeterminado: 10).

Ejemplo de uso :

const response = await client.callTool({
  name: "search_google_documents",
  arguments: {
    query: "検索キーワード",
    maxResults: 5
  }
});

Ejemplo de uso de un programa

Ejemplo de uso del cliente MCP desde un programa TypeScript o JavaScript:

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

async function main() {
  // MCPクライアントの作成
  const client = new Client({
    name: "google-docs-client",
    version: "1.0.0"
  });

  // Google Docs MCPサーバーへの接続
  const transport = new StdioClientTransport({
    command: "npm",
    args: ["run", "mcp"]
  });

  await client.connect(transport);

  // サーバー情報の取得
  const info = await client.getServerInfo();
  console.log("利用可能なツール:", info.tools);

  // ドキュメントの検索
  const searchResult = await client.callTool({
    name: "search_google_documents",
    arguments: {
      query: "会議資料",
      maxResults: 5
    }
  });
  console.log("検索結果:", searchResult);

  // 接続を閉じる
  await client.disconnect();
}

main().catch(console.error);

solución de problemas

Si ocurre un error de conexión con Cursor

Realice un reinicio completo del Cursor.
Asegúrese de que la configuración .cursor/mcp.json sea correcta.
Inicie manualmente el servidor MCP y verifique que funciona:
npm run dev
Verifique que al ejecutar este comando aparezca el mensaje “Google Docs MCP Server iniciado” y que el proceso continúe ejecutándose sin salir.
Verifique la sección "Servidor MCP" en la configuración de Cursor y asegúrese de que el servidor "google-docs" esté en la lista.

Si recibe un error de autenticación de Google

Asegúrese de que el archivo credentials.json esté ubicado correctamente en la raíz del proyecto.
Si token.json existe, elimínelo e intente autenticarse nuevamente.
Verifique que la API de Google Drive y la API de Google Docs estén habilitadas para su proyecto en Google Cloud Console.

Ampliar y configurar

Este servidor MCP está diseñado teniendo en cuenta la extensibilidad, lo que le permite agregar nuevas funciones como:

src/googleDocsService.ts : agrega nuevos métodos a la clase GoogleDocsService.
src/index.ts : define nuevas herramientas y las registra en el servidor

Notas

La primera vez que ejecute la aplicación, se mostrará una pantalla de autorización para la autenticación de Google. Después de la autenticación, el token se guarda en un archivo y se utiliza automáticamente en ejecuciones posteriores.
Se pueden aplicar cargos de Google Cloud Platform según el uso que haga de la API.

licencia

Licencia MIT

Google Docs MCP Server

Integrations