English Français العربية

io.github.LeoMbm/malt-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

MCP server for Malt.fr. Read your freelance profile, stats, and missions from Claude.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package malt-mcp
Claude Code 
claude mcp add malt-mcp -- uvx malt-mcp==0.3.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "malt-mcp": {
            "command": "uvx",
            "args": [
                "malt-mcp==0.3.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Malt MCP Server
  2. Tools
  3. 📦 Claude Desktop MCP Bundle
  4. 🚀 uvx Setup (Universal)
  5. ⚙️ CLI Options
  6. ❗ Troubleshooting
  7. 🔒 How it works
  8. 🐍 Development
  9. License

Malt MCP Server

MCP server for Malt.fr. Lets Claude (or any MCP client) read your freelance profile, stats, and missions.

Tools

ToolDescriptionStatus
authenticateLog in to Malt interactively from Claude Desktopworking
get_profileGet freelance profile info (bio, daily rate, skills, rating). Omit username to fetch your own profile.working
get_statisticsView profile stats (views, response rate, missions)working
get_missionsList mission conversations from messagingworking
get_mission_detailsGet full details of a specific mission (budget, skills, messages)working
close_sessionClose the browser and free resourcesworking

📦 Claude Desktop MCP Bundle

Prerequisites: Claude Desktop.

One-click installation:

  1. Download the latest .mcpb from releases
  2. Double-click the .mcpb file to install it into Claude Desktop
  3. Ask Claude "connecte-moi a Malt" - a browser opens, you log in, done
  4. Call any Malt tool

No terminal needed. Session is saved in ~/.malt-mcp/ and reused across restarts.

[!NOTE] Google OAuth doesn't work (blocked by Google when automated). Use email/password.

🚀 uvx Setup (Universal)

Prerequisites: uv installed.

Add to your MCP client config (Claude Desktop, Claude Code, or any MCP-compatible client):

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

@latest pulls the newest version from PyPI on each launch. First auth-requiring call opens a browser for login.

To log in ahead of time:

uvx malt-mcp@latest --login
Docker (coming soon)

⚙️ CLI Options

OptionDescription
--loginOpen browser to log in and save session
--logoutClear stored browser profile
--no-headlessShow browser window (debug)
--log-levelSet log level (DEBUG, INFO, WARNING, ERROR)
--timeoutBrowser timeout in ms (default: 5000)

❗ Troubleshooting

Login issues:

  • Google OAuth won't work. Use email/password.
  • Session expired? Re-run uvx malt-mcp@latest --login.
  • Cloudflare challenge on first load is normal - the browser handles it, give it a few seconds.

Timeout issues:

  • Pages not loading? Try --timeout 10000. Slow connections might need 15000.

Browser issues:

  • Headless mode doesn't work - Cloudflare blocks it. The browser window is expected.
  • First run downloads Chromium (~200 MB via Patchright). One-time thing.
  • Upgrading from v0.3.x? Run uvx malt-mcp@latest --logout then --login. The browser engine changed from system Chrome to managed Chromium.

🔒 How it works

Under the hood, this is browser automation via Patchright (Playwright fork). No API, no reverse-engineering - it drives a real browser like you would.

  • Credentials stay local. Cookies live in ~/.malt-mcp/profile/, nowhere else.
  • Read-only. Nothing is modified on your Malt account (for now).
  • Runs locally. The server talks to Malt.fr and nothing else.

[!IMPORTANT] Malt's TOS may prohibit automated tools. Don't bulk-scrape. Use responsibly.

🐍 Development

Contributions welcome! See CONTRIBUTING.md for architecture guidelines.

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

Run the MCP Inspector (local testing):

uv run mcp dev malt_mcp_server/server.py

Run tests:

uv run pytest --cov -v

Type check:

uv run ty check

License

Apache 2.0

الأسئلة الشائعة

ما هو io.github.LeoMbm/malt-mcp؟

MCP server for Malt.fr. Read your freelance profile, stats, and missions from Claude.

كيف أثبّت io.github.LeoMbm/malt-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add malt-mcp -- uvx malt-mcp==0.3.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.LeoMbm/malt-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.LeoMbm/malt-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.LeoMbm/malt-mcp؟

ينشره LeoMbm. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.