Windsurf + pdfmcp: 설정 가이드

mcp_config.json을 통해 pdfmcp를 Windsurf Cascade에 추가합니다.

로컬만 해당됩니다. 같은 74개 도구가 사용자의 컴퓨터에서 실행됩니다. 계정 없음, 키 없음, 제한 없음. Windsurf에서는 이 페이지의 구성으로 pdfmcp가 사용자의 컴퓨터에서 실행됩니다. 구성을 바꾸면 언제든 다시 설치하거나 클라이언트를 변경할 수 있습니다.

필요한 것: 로컬 pdfmcp 패키지: 한 번 설치하세요(또는 첫 시작 시 uvx가 다운로드하게 하세요). 계정도, 키도, 교체할 비밀도 없습니다.

들어가는 위치: Wherever your client keeps its MCP server list

{
  "mcpServers": {
    "pdfmcp": {
      "command": "uvx",
      "args": [
        "--from",
        "https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl",
        "pdfmcp"
      ]
    }
  }
}

단계

1. Save the config at the location above — uvx fetches the pdfmcp package on first launch, so there is nothing to install by hand (or install it once with the pip command on the MCP page and use "command": "pdfmcp").
2. Restart Windsurf so it loads the new server.
3. Ask the agent to run a pdfmcp tool — it executes on this machine, and your files never leave it.

문제 해결

• 로컬 서버가 시작되지 않음: 패키지를 pip install https://pdfmcp.org/downloads/pdfmcp-4.2.1-py3-none-any.whl(으)로 한 번 설치하고 터미널에서 pdfmcp를 실행해 오류를 확인하세요 — 보통 패키지 다운로드가 차단되었거나 Python이 3.11보다 오래된 경우입니다.
• 도구가 나타나지 않습니다: 구성을 편집한 뒤 클라이언트를 완전히 재시작하세요. 대부분의 클라이언트는 시작할 때만 MCP 서버를 불러옵니다.
• 엔진이 시작되지 않습니다: 무거운 엔진은 첫 사용 시 한 번만 다운로드됩니다. 그 다운로드를 위한 연결을 확인하고 다시 시도하세요. 이후에는 모든 것이 로컬로 작동합니다.

다음으로 시도해 보세요

다른 클라이언트: Claude Desktop MCP 설정 · Claude Code MCP 설정 · ChatGPT MCP 설정 · 모든 MCP 설정 가이드 · 로컬 API 가이드