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
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
- 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 MCPSERVER_VERSION : Versión del servidor MCPCREDENTIALS_PATH : Ruta al archivo de credenciales de la API de GoogleTOKEN_PATH : Ruta para almacenar el token de autenticación
- Inicie el servidor de desarrollo y obtenga un token: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
ejecución
Ejecutar como un servidor normal:
Ejecutándose en modo de desarrollo:
Ú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: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