levels-fyi-mcp

levels.fyi에서 보상 데이터를 조회하기 위한 MCP 서버입니다.

이 서버가 제공하는 기능

서버 이름: MyPlayground

도구:

• calculate_addition(a: int, b: int) -> int

• get_mock_weather(city: str) -> str (모의 날씨, 실제 API 데이터 아님)

• generate_username(base_name: str, add_numbers: bool = true) -> str

Related MCP server: FastMCP Demo Server

최종 사용자 설치 (Cursor에서 사용)

이 섹션은 Cursor에서 MCP 서버를 설치하고 실행하려는 사용자 전용입니다.

요구 사항

• Python >=3.11

• uv

Cursor MCP 구성 (권장)

Cursor가 프로젝트 환경을 직접 사용하도록 uv run을 사용하세요.

{
  "mcpServers": {
    "user-MyPlayground": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/absolute/path/to/levels-fyi-mcp"
    }
  }
}

사용 시작하기

1. Cursor MCP 설정을 열고 위의 서버 구성을 추가합니다.

2. cwd가 이 저장소의 로컬 복제본을 가리키는지 확인합니다.

3. Cursor에서 MCP 서버를 시작/재로드합니다.

4. calculate_addition, get_mock_weather, generate_username과 같은 도구를 호출합니다.

선택 사항: 직접 fastmcp 명령

Cursor에서 command: "fastmcp"를 선호하는 경우, 전역 도구로 설치하세요:

uv tool install fastmcp

Cursor가 fastmcp를 찾을 수 없는 경우, 위에서 권장하는 uv run 구성을 사용하세요.

개발자 설정

이 섹션은 코드 변경 작업을 하는 기여자들을 위한 것입니다.

종속성 설치

프로젝트 루트에서:

uv sync

로컬에서 서버 실행

uv run python main.py

종속성 추가 또는 업데이트

uv add <package>
uv sync

빠른 환경 확인

uv run python -c "import fastmcp; print('fastmcp ok')"

프로젝트 구조

.
├── main.py
├── pyproject.toml
└── README.md

문제 해결

Failed to spawn: fastmcp (os error 2)

원인: Cursor가 fastmcp 실행 파일을 찾을 수 없습니다.

해결 방법:

1. uv run python main.py를 사용하는 Cursor 구성을 선호하거나,

2. uv tool install fastmcp로 전역 도구를 설치하고 PATH에 uv 도구 bin(일반적으로 ~/.local/bin)이 포함되어 있는지 확인합니다.

도구 인수 유형 오류

• generate_username.add_numbers는 숫자나 문자열이 아닌 불리언(true/false)이어야 합니다.

참고 사항

• get_mock_weather는 데모를 위해 무작위 모의 데이터를 반환합니다.

• 도구 로그는 main.py에서 출력되며 서버 출력에 나타납니다.