🔥 셀프호스팅 FireCrawl MCP 서버 sse 로 업그레이드

기존에 stdio 방식으로 되어 있던 셀프 호스팅하는 firecrawl-mcp를 sse 방식으로 변경하는 작업을 진행했습니다.

https://www.gpters.org/dev/post/private-cost-firecrawl-self-PSp0iLLwBupaVBf

stdio 방식과 sse 방식

STDIO (Standard Input/Output)

STDIO는 표준 입력/출력 스트림을 통해 통신하는 방식입니다. 이 방식에서 서버는 클라이언트의 하위 프로세스로 실행됩니다.

• 클라이언트와 서버는 stdin을 통해 JSON 메시지를 받고 stdout을 통해 응답합니다

• 메시지는 줄바꿈으로 구분되어야 합니다

• 서버는 로깅을 위해 stderr를 사용할 수 있습니다

• 서버는 유효한 MCP 메시지가 아닌 내용을 stdout에 쓰면 안 되며, 클라이언트도 유효한 MCP 메시지가 아닌 내용을 서버의 stdin에 쓰면 안 됩니다

SSE (Server-Sent Events)

SSE는 HTTP 요청을 통해 통신하는 방식으로, 클라이언트-서버 통신에는 HTTP POST 요청을, 서버-클라이언트 통신에는 Server-Sent Events를 사용합니다.

• 클라이언트는 표준 HTTP POST 요청을 통해 명령을 서버에 전송합니다

• 서버는 SSE 연결을 유지하여 클라이언트에 메시지를 푸시합니다

• 분산 아키텍처와 여러 동시 클라이언트를 지원합니다

• 클라이언트와 서버는 분리된 프로세스로 실행될 수 있으며, 심지어 분리된 노드에서도 실행 가능합니다

개발은 Windsurf로 진행

• MCP 공식 python SDK 내용 중 sse 관련 코드, md 파일만 Windsurf에 추가하고 직접 참조하는 방식으로 진행

• 큰 무리 없이 완료

개발이 완료됐으니 테스트

• MCP 서버 실행
  python firecrawl_mcp.py --transport sse --port 8000

• MCP Inspector

  • MCP Inspector는 개발자가 MCP 서버 구현을 테스트하고 디버깅할 수 있게 해주는 도구

  • 설치할 필요 없이 다음 명령어로 바로 사용 가능
    npx @modelcontextprotocol/inspector node build/index.js

    

    ALT

    이중 컨텍스트 프로토콜 검사관을 읽는 메시지가 포함 된 검은 색 화면은 IP Inspector IP Inspector IP입니다.

    • 표시되는 주소로 접속

  • Transport Type을 SSE로 변경
    

    

    ALT

    검은 색 배경이있는 웹 브라우저의 스크린 샷

    1. 구동시킨 MCP 서버 주소 입력

    2. Connect버튼으로 MCP 서버 연결

    3. Tools 탭 선택

    4. List Tools 로 사용할 수 있는 Tool 리스트 화인

    5. 테스트할 Tool 선택

    6. 주소 입력

    7. 실행 테스트

Claude Desktop 연동

• 기본적으로 Claude Desktop은 stdio 방식만 지원

• mcp-remote 를 사용 sse 방식 적용 가능

  • 설치
    npm install -g mcp-remote

• 설정

	"mcpServers": {
		"firecrawl_mcp": {
			"command": "npx",
			"args": [
				"mcp-remote",
				"http://localhost:8000/firecrawl/sse"
			]
		}
	}

결론

생각 보다 쉽게 진행됐으며 앞으로 sse 방식으로 기존에 개발해서 사용하는 Obsidisan MCP 서버도 sse 방식으로 교체할 예정입니다.