SFML 3.1.0 Documentation MCP Server (sfml3-ref)

AI 어시스턴트(Claude Desktop, Cursor, Claude Code, Cline 등)에게 완전한 SFML 3.1.0 C++ 참조 문서에 대한 직접적이고 오프라인 액세스를 제공하는 공식 Model Context Protocol (MCP) 서버입니다.

🌟 기능

• 깔끔한 Markdown API 참조: Doxygen HTML 문서를 파싱하여 구문 강조된 C++ 코드 블록이 포함된 형식화된 GitHub Markdown으로 정리합니다.

• 전체 C++20 시그니처: 지정자([[nodiscard]], constexpr, explicit, delete, 기본 인자)가 포함된 전체 메서드 프로토타입.

• 모듈별 분류: 5개의 SFML 모듈(System, Window, Graphics, Audio, Network)에 걸쳐 155개 이상의 모든 심볼이 분류됩니다.

• 빠른 인메모리 검색: 심볼 이름, 멤버 함수, 매개변수, 설명에 대해 1밀리초 미만의 조회.

• 스마트 별칭: 일반적인 SFML typedef 및 헬퍼의 직접 해석 (예: Vector2f ➔ sf::Vector2<T>, IntRect ➔ sf::Rect<T>, seconds ➔ sf::Time).

Related MCP server: godot-mcp-docs

🛠️ MCP 도구

🚀 시작하기

사전 요구 사항

• Node.js (v18.0.0 이상 권장)

• npm

설치 및 빌드

# 1. Clone the repository
git clone https://github.com/Floxius/sfml3-ref.git
cd sfml3-ref

# 2. Install dependencies
npm install

# 3. Build the TypeScript server
npm run build

참고: 저장소에는 이미 사전 빌드된 index.json(~1MB)이 포함되어 있으므로, 인덱싱 스크립트를 다시 실행하려는 경우가 아니라면 원본 SFML Doxygen HTML 파일을 다운로드할 필요가 없습니다.

🖥️ 클라이언트 구성

1. Claude Desktop

Claude Desktop 구성 파일에 서버를 추가하세요:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/sfml3-ref/dist/src/index.js"
      ]
    }
  }
}

(Windows에서는 슬래시 또는 이중 백슬래시를 사용하세요, 예: C:/Users/<username>/Documents/sfml3-ref/dist/src/index.js)

대안: tsx로 직접 실행 (빌드 단계 불필요)

{
  "mcpServers": {
    "sfml3-ref": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/ABSOLUTE/PATH/TO/sfml3-ref/src/index.ts"
      ]
    }
  }
}

2. Cursor / Cline / 기타 MCP 클라이언트

다음 설정으로 STDIO MCP 서버를 추가하세요:

• 명령: node

• 인자: ["/path/to/sfml3-ref/dist/src/index.js"]

📖 사용 예시

Claude 또는 MCP 클라이언트에 연결되면 다음과 같은 프롬프트를 요청할 수 있습니다:

• "SFML 3.1에서 사용 가능한 모든 모듈을 나열해 줘."

• "SFML Graphics 모듈의 모든 클래스와 함수를 보여줘."

• "SFML 3에서 sf::Sprite의 생성자 시그니처는 무엇인가요?"

• "SFML 3.1에서 sf::Dns로 DNS 레코드를 어떻게 조회하나요?"

• "SFML 3에서 이벤트 처리 메서드를 검색해 줘."

🔄 인덱스 다시 빌드 (선택 사항)

index.json을 처음부터 다시 생성하려면:

1. SFML 웹사이트에서 SFML 3.1.0 Doxygen HTML 문서를 다운로드하세요.

2. HTML 파일을 저장소 루트의 SFML-3.1.0 폴더에 압축 해제하세요.

3. 인덱싱 스크립트를 실행하세요:

   npm run build:index

📄 라이선스

• 서버 코드: MIT 라이선스에 따라 라이선스가 부여됩니다.

• SFML 문서 및 라이브러리: Copyright © Laurent Gomila & SFML Team. SFML은 zlib/png 라이선스의 이용 약관에 따라 라이선스가 부여됩니다.