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 から出力され、サーバーの出力に表示されます。