malt-mcp

Malt MCP サーバー

Malt.fr 用の MCP サーバーです。Claude（または任意の MCP クライアント）から、フリーランスのプロフィール、統計情報、案件を参照できます。

ツール

ツール	説明	ステータス
authenticate	Claude Desktop から Malt に対話形式でログインします	動作中
get_profile	フリーランスのプロフィール情報（自己紹介、日額料金、スキル、評価）を取得します。ユーザー名を省略すると、自分のプロフィールを取得します。	動作中
get_statistics	プロフィールの統計情報（閲覧数、返信率、案件）を確認します	動作中
get_missions	メッセージから案件の会話を一覧表示します	動作中
get_mission_details	特定の案件の詳細（予算、スキル、メッセージ）を取得します	動作中
close_session	ブラウザーを閉じてリソースを解放します	動作中

📦 Claude Desktop MCP Bundle

前提条件： Claude Desktop。

ワンクリックでインストール：

1. リリースから最新の .mcpb をダウンロードします
2. .mcpb ファイルをダブルクリックして Claude Desktop にインストールします
3. Claude に「connecte-moi a Malt」と尋ねます。ブラウザーが開くので、ログインすれば完了です
4. 任意の Malt ツールを呼び出します

ターミナルは不要です。セッションは ~/.malt-mcp/ に保存され、再起動後も再利用されます。

メモ

Google OAuth は機能しません（自動操作が Google にブロックされます）。メールアドレスとパスワードを使用してください。

🚀 uvx のセットアップ（共通）

前提条件： uv がインストールされていること。

MCP クライアント（Claude Desktop、Claude Code、または任意の MCP 対応クライアント）の設定に追加します。

{
  "mcpServers": {
    "malt": {
      "command": "uvx",
      "args": ["malt-mcp@latest"],
      "env": { "UV_HTTP_TIMEOUT": "300" }
    }
  }
}

@latest を指定すると、起動するたびに PyPI から最新バージョンを取得します。認証が必要な最初の呼び出しでブラウザーが開き、ログインできます。

事前にログインするには：

uvx malt-mcp@latest --login

Docker（近日公開）

⚙️ CLI オプション

オプション	説明
--login	ログインしてセッションを保存するため、ブラウザーを開きます
--logout	保存されたブラウザープロファイルを消去します
--no-headless	ブラウザーウィンドウを表示します（デバッグ用）
--log-level	ログレベルを設定します（DEBUG、INFO、WARNING、ERROR）
--timeout	ブラウザーのタイムアウトをミリ秒単位で設定します（デフォルト：5000）

❗ トラブルシューティング

ログインの問題：

• Google OAuth は機能しません。メールアドレスとパスワードを使用してください。
• セッションの有効期限が切れましたか？ uvx malt-mcp@latest --login を再実行してください。
• 初回読み込み時に Cloudflare のチャレンジが表示されるのは正常です。ブラウザーが処理するので、数秒お待ちください。

タイムアウトの問題：

• ページが読み込まれませんか？ --timeout 10000 を試してください。接続が遅い場合は 15000 が必要になることがあります。

ブラウザーの問題：

• ヘッドレスモードは機能しません。Cloudflare にブロックされます。ブラウザーウィンドウが表示されるのが正常です。
• 初回実行時に Chromium（約200 MB、Patchright 経由）がダウンロードされます。これは初回のみです。
• v0.3.x からアップグレードしますか？ uvx malt-mcp@latest --logout を実行し、続けて --login を実行してください。ブラウザーエンジンがシステムの Chrome から管理対象の Chromium に変更されました。

🔒 仕組み

内部では、Patchright（Playwright のフォーク）を使ったブラウザー自動化を行います。API やリバースエンジニアリングは不要で、実際にブラウザーを操作するのと同じように動作します。

• 認証情報はローカルに保存されます。 Cookie は ~/.malt-mcp/profile/ に保存され、それ以外の場所には保存されません。
• 読み取り専用です。 Malt アカウントの内容は変更されません（現時点では）。
• ローカルで実行されます。 サーバーは Malt.fr とのみ通信します。

重要

Malt の利用規約では、自動化ツールが禁止されている場合があります。大量のスクレイピングは行わず、責任を持ってご利用ください。

🐍 開発

コントリビューションを歓迎します。アーキテクチャのガイドラインについては、CONTRIBUTING.md をご覧ください。

git clone https://github.com/LeoMbm/malt-mcp.git
cd malt-mcp
uv sync --group dev
pre-commit install

MCP Inspector を実行（ローカルテスト）：

uv run mcp dev malt_mcp_server/server.py

テストを実行：

uv run pytest --cov -v

型チェック：

uv run ty check

ライセンス

Apache 2.0