levels-fyi-mcp

Servidor MCP para consultar datos de compensación de levels.fyi.

Qué proporciona este servidor

Nombre del servidor: MyPlayground

Herramientas:

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

• get_mock_weather(city: str) -> str (clima simulado, no datos de API reales)

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

Related MCP server: FastMCP Demo Server

Instalación para el usuario final (Uso en Cursor)

Esta sección es para usuarios que solo desean instalar y ejecutar el servidor MCP en Cursor.

Requisitos

• Python >=3.11

• uv

Configuración de MCP en Cursor (recomendado)

Utilice uv run para que Cursor utilice el entorno del proyecto directamente.

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

Empiece a usarlo

1. Abra la configuración de MCP en Cursor y añada la configuración del servidor anterior.

2. Asegúrese de que cwd apunte a su clon local de este repositorio.

3. Inicie/recargue los servidores MCP en Cursor.

4. Llame a herramientas como calculate_addition, get_mock_weather y generate_username.

Opcional: comando directo fastmcp

Si prefiere command: "fastmcp" en Cursor, instálelo como una herramienta global:

uv tool install fastmcp

Si Cursor no puede encontrar fastmcp, utilice la configuración recomendada uv run anterior.

Configuración para desarrolladores

Esta sección es para colaboradores que trabajan en cambios de código.

Instalar dependencias

Desde la raíz del proyecto:

uv sync

Ejecutar el servidor localmente

uv run python main.py

Añadir o actualizar dependencias

uv add <package>
uv sync

Verificación rápida del entorno

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

Estructura del proyecto

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

Solución de problemas

Error al iniciar: fastmcp (os error 2)

Causa: Cursor no puede encontrar el ejecutable fastmcp.

Solución:

1. Prefiera la configuración de Cursor con uv run python main.py, o

2. Instale la herramienta global con uv tool install fastmcp y asegúrese de que PATH incluya el binario de la herramienta uv (normalmente ~/.local/bin).

Errores de tipo en los argumentos de la herramienta

• generate_username.add_numbers debe ser booleano (true/false), no números ni cadenas.

Notas

• get_mock_weather devuelve datos simulados aleatorios para demostraciones.

• Los registros de la herramienta se imprimen desde main.py y aparecen en la salida del servidor.