Google Docs MCP Server

Implementation Reference

• src/mcp/tools/searchDocuments.ts:32-60 (handler)

  The core handler function that executes the Google Documents search using the Google Docs service.

  protected async executeInternal(args: {
  	query: string;
  	maxResults?: number;
  }): Promise<McpToolResponse> {
  	// 引数検証
  	this.validateArgs(args, ["query"]);
  
  	const { query, maxResults = 10 } = args;
  	this.logger.info(
  		`ドキュメント検索開始: クエリ="${query}", 最大結果数=${maxResults}`,
  	);
  
  	try {
  		// Google Docsサービスを取得
  		const docsService = await this.serviceContainer.getGoogleDocsService();
  
  		// ドキュメントを検索
  		const results = await docsService.searchForDocuments(query, maxResults);
  
  		this.logger.info(
  			`ドキュメント検索完了: クエリ="${query}", 結果件数=${results.length}`,
  		);
  
  		return this.createSuccessResponse(JSON.stringify(results, null, 2));
  	} catch (error) {
  		this.logger.error(`ドキュメント検索エラー: クエリ="${query}"`, error);
  		throw error; // BaseMcpToolでエラーハンドリング
  	}
  }

• src/mcp/tools/searchDocuments.ts:19-27 (schema)

  Zod schema defining the input parameters: query (required string) and optional maxResults (number).

  get schema() {
  	return {
  		query: z.string().describe("検索クエリ"),
  		maxResults: z
  			.number()
  			.optional()
  			.describe("取得する最大結果数（デフォルト: 10）"),
  	};
  }

• src/mcp/tools/searchDocuments.ts:12-14 (registration)

  Constructor calls super to register the tool with name 'search_google_documents'.

  constructor(serviceContainer: IServiceContainer) {
  	super("search_google_documents", serviceContainer);
  }

• src/mcp/registry.ts:56-56 (registration)

  Instantiates and registers the SearchDocumentsTool in the default tools registry.

  this.registerTool(new SearchDocumentsTool(this.serviceContainer));