mirror of
https://github.com/CherryHQ/cherry-studio.git
synced 2025-12-19 06:30:10 +08:00
d41229c69b
* ✨ feat: add CDP browser MCP server * ♻️ refactor: add navigation timeout for browser cdp * 🐛 fix: reuse window for execute and add debugger logging * ✨ feat: add show option and multiline execute for browser cdp * ✨ feat: support multiple sessions for browser cdp * ♻️ refactor: add LRU and idle cleanup for browser cdp sessions * Refactor browser-cdp for readability and set Firefox UA * 🐛 fix: type electron mock for cdp tests * ♻️ refactor: rename browser_cdp MCP server to browser Simplify the MCP server name from @cherry/browser-cdp to just browser for cleaner tool naming in the MCP protocol. * ✨ feat: add fetch tool to browser MCP server Add a new `fetch` tool that uses the CDP-controlled browser to fetch URLs and return content in various formats (html, txt, markdown, json). Also ignore .conductor folder in biome and eslint configs. * ♻️ refactor: split browser MCP server into modular folder structure Reorganize browser.ts (525 lines) into browser/ folder with separate files for better maintainability. Each tool now has its own file with schema, definition, and handler. * ♻️ refactor: use switch statement in browser server request handler * ♻️ refactor: extract helpers and use handler registry pattern - Add successResponse/errorResponse helpers in tools/utils.ts - Add closeWindow helper to consolidate window cleanup logic - Add ensureDebuggerAttached helper to consolidate debugger setup - Add toolHandlers map for registry-based handler lookup - Simplify server.ts to use dynamic handler dispatch * 🐛 fix: improve browser MCP server robustness - Add try-catch for JSON.parse in fetch() to handle invalid JSON gracefully - Add Zod schema validation to reset tool for consistency with other tools - Fix memory leak in open() by ensuring event listeners cleanup on timeout - Add JSDoc comments for key methods and classes * ♻️ refactor: rename browser MCP to @cherry/browser Follow naming convention of other builtin MCP servers. * 🌐 i18n: translate pending strings across 8 locales Translate all "[to be translated]" markers including: - CDP browser MCP server description (all 8 locales) - "Extra High" reasoning chain length option (6 locales) - Git Bash configuration strings (el-gr, ja-jp)
50 lines
1.6 KiB
TypeScript
50 lines
1.6 KiB
TypeScript
import * as z from 'zod'
|
|
|
|
import type { CdpBrowserController } from '../controller'
|
|
import { errorResponse, successResponse } from './utils'
|
|
|
|
export const FetchSchema = z.object({
|
|
url: z.url().describe('URL to fetch'),
|
|
format: z.enum(['html', 'txt', 'markdown', 'json']).default('markdown').describe('Output format (default: markdown)'),
|
|
timeout: z.number().optional().describe('Timeout in milliseconds for navigation (default: 10000)'),
|
|
sessionId: z.string().optional().describe('Session identifier (default: default)')
|
|
})
|
|
|
|
export const fetchToolDefinition = {
|
|
name: 'fetch',
|
|
description: 'Fetch a URL using the browser and return content in specified format (html, txt, markdown, json)',
|
|
inputSchema: {
|
|
type: 'object',
|
|
properties: {
|
|
url: {
|
|
type: 'string',
|
|
description: 'URL to fetch'
|
|
},
|
|
format: {
|
|
type: 'string',
|
|
enum: ['html', 'txt', 'markdown', 'json'],
|
|
description: 'Output format (default: markdown)'
|
|
},
|
|
timeout: {
|
|
type: 'number',
|
|
description: 'Navigation timeout in milliseconds (default: 10000)'
|
|
},
|
|
sessionId: {
|
|
type: 'string',
|
|
description: 'Session identifier (default: default)'
|
|
}
|
|
},
|
|
required: ['url']
|
|
}
|
|
}
|
|
|
|
export async function handleFetch(controller: CdpBrowserController, args: unknown) {
|
|
const { url, format, timeout, sessionId } = FetchSchema.parse(args)
|
|
try {
|
|
const content = await controller.fetch(url, format, timeout ?? 10000, sessionId ?? 'default')
|
|
return successResponse(typeof content === 'string' ? content : JSON.stringify(content))
|
|
} catch (error) {
|
|
return errorResponse(error as Error)
|
|
}
|
|
}
|