levels-fyi-mcp

MCP-сервер для запроса данных о компенсациях с levels.fyi.

Что предоставляет этот сервер

Имя сервера: 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)

Этот раздел предназначен для пользователей, которые хотят только установить и запустить MCP-сервер в Cursor.

Требования

• Python >=3.11

• uv

Конфигурация MCP в Cursor (рекомендуется)

Используйте uv run, чтобы Cursor напрямую использовал окружение проекта.

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

Начало работы

1. Откройте настройки MCP в Cursor и добавьте конфигурацию сервера выше.

2. Убедитесь, что cwd указывает на вашу локальную копию этого репозитория.

3. Запустите/перезагрузите MCP-серверы в Cursor.

4. Вызывайте инструменты, такие как calculate_addition, get_mock_weather и generate_username.

Опционально: прямая команда fastmcp

Если вы предпочитаете command: "fastmcp" в Cursor, установите его как глобальный инструмент:

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. Отдавайте предпочтение конфигурации Cursor с uv run python main.py, или

2. Установите глобальный инструмент с помощью uv tool install fastmcp и убедитесь, что PATH включает папку с инструментами uv (обычно ~/.local/bin).

Ошибки типа аргументов инструмента

• generate_username.add_numbers должен быть логическим значением (true/false), а не числами или строками.

Примечания

• get_mock_weather возвращает рандомизированные имитационные данные для демонстрации.

• Журналы инструментов выводятся из main.py и отображаются в выводе сервера.