malt-mcp

Malt MCP Server

适用于 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. 从 releases 下载最新的 .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