셀레늄 MCP 서버

대장간 배지

Selenium을 사용하여 WebDriver 인스턴스와 상호 작용하는 MCP 서버입니다. MCP-Server-Starter 템플릿을 사용하여 빌드되었습니다.

개요

이 서버를 사용하면 AI 에이전트가 Selenium WebDriver를 통해 웹 브라우저 세션을 제어할 수 있어 Model Context Protocol을 통해 웹 스크래핑, 자동 테스트, 양식 작성과 같은 작업이 가능합니다.

핵심 구성 요소

MCP 서버 : Selenium WebDriver 작업을 MCP 도구로 제공합니다.
Selenium WebDriver : 브라우저와 상호작용합니다.
MCP 클라이언트 : 노출된 도구를 활용할 수 있는 AI 호스트(Cursor, Claude Desktop 등)입니다.

필수 조건

Node.js(v18 이상)
npm(v7 이상)
WebDriver 실행 파일 (예: ChromeDriver, GeckoDriver)이 시스템의 PATH에 설치되어 사용 가능해야 합니다.
호환되는 웹 브라우저 (예: Chrome, Firefox)

시작하기

저장소를 복제합니다.지엑스피1
종속성 설치:
npm install
WebDriver 구성:
- WebDriver(예: chromedriver )가 설치되어 있고 PATH에 있는지 확인하세요.
- 필요한 경우 브라우저 옵션이나 WebDriver 경로를 지정하기 위해 src/seleniumService.ts (이 파일을 직접 생성함)를 수정합니다.
서버를 빌드하세요:
npm run build
서버를 실행합니다:
npm start
또는 Cursor나 Claude Desktop과 같은 MCP 호스트와 통합할 수 있습니다(아래 통합 섹션 참조).

도구

이 서버는 다음과 같은 도구를 제공합니다.

selenium_navigate : 브라우저를 특정 URL로 이동합니다.
selenium_findElement : CSS 선택기를 사용하여 페이지에서 요소를 찾습니다.
selenium_click : 요소를 클릭합니다.
selenium_sendKeys : 키 입력을 요소에 전송합니다.
selenium_getPageSource : 현재 페이지 소스 HTML을 검색합니다.
(필요에 따라 도구를 더 추가하세요)

TypeScript 구현

서버는 @modelcontextprotocol/sdk 및 selenium-webdriver 라이브러리를 사용합니다.

import { Server } from "@modelcontextprotocol/sdk/server/index.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { Builder, By, Key, until, WebDriver } from 'selenium-webdriver';

// Basic server setup (details in src/index.ts)
const server = new Server({
  name: "selenium-mcp-server",
  version: "0.1.0",
  capabilities: {
    tools: {}, // Enable tools capability
  }
});

// Selenium WebDriver setup (details in src/seleniumService.ts)
let driver: WebDriver;

async function initializeWebDriver() {
  driver = await new Builder().forBrowser('chrome').build(); // Or 'firefox', etc.
}

// Example tool implementation (details in src/tools/)
server.registerTool('selenium_navigate', {
  description: 'Navigates the browser to a specific URL.',
  inputSchema: { /* ... zod schema ... */ },
  outputSchema: { /* ... zod schema ... */ },
  handler: async (params) => {
    await driver.get(params.url);
    return { success: true };
  }
});

// Connect transport
async function startServer() {
  await initializeWebDriver();
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.log("Selenium MCP Server connected via stdio.");

  // Graceful shutdown
  process.on('SIGINT', async () => {
    console.log("Shutting down WebDriver...");
    if (driver) {
      await driver.quit();
    }
    process.exit(0);
  });
}

startServer();

개발

빌드: npm run build
실행: npm start ( node build/index.js 실행)
린트: npm run lint
형식: npm run format

디버깅

MCP Inspector나 표준 Node.js 디버깅 기술을 사용하세요.

MCP 호스트와의 통합

(Cursor, Claude Desktop, Smithery 등의 원래 README에서 관련 섹션을 유지하고 필요에 따라 경로와 명령을 업데이트합니다)

커서 통합

서버를 빌드하세요 : npm run build
커서: Settings > Features > MCP : 새로운 MCP 서버를 추가합니다.
서버를 등록하세요 :
- 전송 유형으로 stdio 선택합니다.
- 이름: Selenium Server (또는 유사한 서버).
- 명령어: node /path/to/selenium-mcp-server/build/index.js .
구하다 .

Claude 데스크톱 통합

서버를 빌드하세요 : npm run build
claude_desktop_config.json수정합니다 :
{ "mcpServers": { "selenium-mcp-server": { "command": "node", "args": [ "/path/to/selenium-mcp-server/build/index.js" ] } } }
Claude Desktop을 다시 시작합니다 .

모범 사례

유형 안전성과 검증을 위해 TypeScript와 Zod를 사용하세요.
도구를 모듈식으로 유지합니다(예: src/tools/ 에 도구당 하나의 파일).
WebDriver 오류를 정상적으로 처리합니다(예: 요소를 찾을 수 없음, 탐색 문제).
적절한 WebDriver 종료를 보장합니다(예: 서버 종료 시 driver.quit() ).
스키마, 오류 처리 및 콘텐츠 유형에 대한 MCP 모범 사례를 따르세요.

자세히 알아보기

크레딧

Seth Rose가 만든 템플릿을 기반으로 :

웹사이트 : https://www.sethrose.dev
𝕏 (트위터) : https://x.com/TheSethRose
🔥 (블루스카이) : https://bsky.app/profile/sethrose.dev

Integrations