본문으로 건너뛰기

원래 알고 있던 척 하고 정리하는 MCP 2 with firecrawl Server 코드 까보기

황인준

2025.03.27

원래 알고 있던 척 하고 정리하는 MCP 2 with firecrawl Server 코드 까보기 본문 이미지

https://www.gpters.org/nocode/post/mcp-organize-pretending-learned-rXXvKZgwgxifwlc

이어서 firecrawl-mcp-server

코드를 보면서 어떻게 MCP 서버가 동작하는지 찾아본 사례 입니다.

🧱 MCP 핵심 구성요소

한국어가있는 검은 색 화면

🔁 전체 흐름 요약(유저 -> AI -> MCP)

한국어의 구조를 보여주는 다이어그램

🔍 Firecrawl MCP 코드 구조

1. 🧰 Client – 도구 정의

const SCRAPE_TOOL: Tool = {
  name: 'firecrawl_scrape',
  description: '웹페이지 스크랩 도구',
  inputSchema: {
    type: 'object',
    properties: {
      url: { type: 'string' },
      formats: { type: 'array', items: { type: 'string' } },
      ...
    },
    required: ['url']
  }
};

📌 이 정의는 MCP 서버가 Host에게 알려주는 도구 설명서 역할을 합니다.

2. 🖥️ Server – 도구 요청 처리

코드 편집기의 스크린 샷
server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === 'firecrawl_scrape') {
    const { url, ...options } = request.params.arguments;
    const response = await client.scrapeUrl(url, options);
    return {
      content: [{ type: 'text', text: response.markdown }],
      isError: false,
    };
  }
});

📌 이 부분이 MCP Server의 핵심:

- Host의 호출 요청을 받아서

- Firecrawl SDK로 API 호출

- 응답을 MCP 형식으로 가공해 반환

3. 🔧 Firecrawl Client – 내부 API 실행

C# 프로그램의 스크린 샷
const client = new FirecrawlApp({
  apiKey: process.env.FIRECRAWL_API_KEY,
});

- 실제 Firecrawl 기능(API)을 호출하는 SDK 인스턴스

- MCP Server 내부에서 도구 호출 시 사용됨

✅ Host, Client, Server 매핑 요약

|MCP 역할|코드 내 요소|

🧾 결론 정리

- Firecrawl은 MCP Server로 구현되어, 다양한 웹 크롤링 기능을 도구처럼 제공한다.

- 코드 상에서는:

- Tool 정의 → Client

- 호출 처리 → Server

- 실제 기능 → Firecrawl SDK

발표 요점: AI에게 Firecrawl을 "자연어로 부를 수 있는 도구"로 바꿔주는 구조

2

함께 이야기해요 2

로그인하고 댓글을 남겨 주세요

온어닷 프로필 이미지
온어닷2025.03.27

이전 시리즈를 통해 개념은 익혔는데.... 이 부분은 조금 더 사전지식이 필요해보이는군요🥲 그럼 이 부분은 mcp가 가용할 수 있는 기능으로 파이어크롤을 넣어놓고, 필요할 때 굳이 지정하지않아도 자연어로 파이어크롤이 사용되도록 지정해놓으신 사례인거죠? 대단하십니다...👍👍

황인준 프로필 이미지
황인준2025.03.27

네! 맞습니다 저는 cursor에 MCP 서버를 붙여서 cursor에서 특정 링크를 주고 크롤링을 시키게 붙여둔 상태입니다.

여기에서 어떤 과정으로 커서가 MCP 하나 붙였다고 크롤링이 되나 궁금해서 firecrawl MCP server 코드를 깃헙에서 내려받아서 어떻게 동작하나 찾아본 사례입니다!

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기