Skip to main content
Glama
deenesjakoruzh
ialejandro

mcp-malt

by ialejandro
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp-malt

用于 Malt API 的 MCP 服务器。它覆盖 Malt 发布的全部 13 个操作：你开具的发票、Malt 向你收取的佣金、你收到的付款，以及组织账户的 SCIM 用户预置。

它覆盖什么和不覆盖什么

Malt 的 API 比大多数人预期的要小。它只覆盖后台计费和企业用户预置，仅此而已：

Toolset

Tools

它覆盖的范围

invoices

3

你向客户开具的发票，包括 PDF

payments

1

你收到的付款，以及每笔付款所结算的发票

fee-invoices

3

Malt 向你开具的佣金发票，包括 PDF

scim

2 读，4 写

组织账户的 SCIM 2.0 用户预置

没有人才搜索、没有个人资料、没有任务、没有报价、没有消息。这些是 Malt 的招牌功能，但它们都不在公共 API 中。如果你是为这些功能而来，这个服务器无法提供，任何基于已文档化 API 构建的其他东西也无法提供。

有两个针对 Malt 的社区 MCP 服务器确实能接触到这些数据，它们通过浏览器自动化驱动 Web 应用并抓取 DOM。它们自己的文档也警告说，自动化编辑个人资料可能违反 Malt 的服务条款。这个服务器只调用已文档化的 API。

Related MCP server: MCP Make.com Server

获取令牌

  1. 如果你还没有账号，请在注册页面上创建一个。

  2. 打开我的账户，然后是 API Keys。

  3. 使用你需要的权限范围创建一个访问令牌，并将其与你计划启用的工具集对应起来。

  4. 立即复制令牌。它只在创建时显示一次，之后不会再显示。

自由职业者账户的令牌可以自助获取。scim 工具集所需的客户团队和组织令牌，则需要通过你的 Malt 代表取得。

这里没有 OAuth 2.0。Malt 没有发布授权服务器和令牌端点，因此上面的 API 令牌是唯一的接入方式。docs/authentication.md 更详细地解释了这一点，包括那个让大多数人踩坑的请求头细节。

安装

同一次发布提供三种安装方式：npm 包（发布在 npmjs 和 GitHub Packages 上）以及 GHCR 上的容器镜像。npx 是 MCP 客户端的常见选择；Docker 适合处于较为封闭或共享的环境。

如果要从 GitHub Packages 而不是 npmjs 安装，请将 scope 指向它：在 .npmrc 中配置 @ialejander:registry=https://npm.pkg.github.com。

npx

// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "npx",
      "args": ["-y", "@ialejandro/mcp-malt"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

Claude Code

claude mcp add malt \
  --env MALT_API_TOKEN=your-token-here \
  --env MALT_TOOLSETS=invoices,payments,fee-invoices \
  -- npx -y @ialejandro/mcp-malt

Docker

服务器通过 stdin 和 stdout 使用 JSON-RPC 通信，因此必须添加 -i，并且不能加 -t。

docker run -i --rm \
  -e MALT_API_TOKEN=your-token-here \
  -e MALT_TOOLSETS=invoices \
  ghcr.io/ialejandro/mcp-malt
// Claude Desktop: claude_desktop_config.json
// Cursor: .cursor/mcp.json
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

从源码安装

git clone https://github.com/ialejandro/mcp-malt
cd mcp-malt
npm ci && npm run build
{
  "mcpServers": {
    "malt": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-malt/dist/index.js"],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}
{
  "mcpServers": {
    "malt": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "MALT_API_TOKEN",
        "-e", "MALT_TOOLSETS",
        "ghcr.io/ialejandro/mcp-malt"
      ],
      "env": {
        "MALT_API_TOKEN": "your-token-here",
        "MALT_TOOLSETS": "invoices,payments,fee-invoices"
      }
    }
  }
}

配置

变量

默认值

作用

MALT_API_TOKEN

必填

你的令牌，来自“我的账户，API Keys”

MALT_TOOLSETS

空

以逗号分隔的 invoices、payments、payment-invoices 或 all

MALT_ALLOW_WRITES

false

暴露四个 SCIM 写入工具。仅启用 scim 时只有读取权限

MALT_MAX_LIST_ITEMS

200

限制列表结果数量，因为 Malt 的计费端点不支持分页

MALT_RATE_LIMIT_RPS

5

出站请求速率。这是我们的设定值，不是 Malt 的，Malt 没有公布任何速率限制

MALT_TIMEOUT_MS

30000

每个请求的超时时间

MALT_API_BASE_URL

https://api.malt.com

覆盖默认地址，主要用于测试

MALT_AUTH_SCHEME

raw

raw 或 bearer。除非 Malt 有所变动，否则不要动它

MALT_LOG_LEVEL

info

debug、info、warn、error。所有日志都会写入到 stderr

如果不设置 MALT_TOOLSETS，服务器会启动但不提供任何工具。这是有意为之，而通知：你决定模型能看到哪些工具。一次只添加一个工具集。

工具集名称未知会让服务器停止并发出错误，而不是悄悄忽略它，因为拼写错误会默默让你丢掉工具，排查起来非常痛苦。

常用任务

按季度对账。 启用 invoices,payments,fee-invoices 并运行 malt_reconcile_revenue 提示词。它会拉取列表全部三份列表，将匹配 payments 与结算的发票，并报告已开票总额、税费、Malt 佣金和已收到的现金。

对账一下我 2026 年第一季度的 Malt 收入。

获取发票 PDF。 Malt 返回的 PDF 用 base64 编码后放在 JSON 响应体中。工具会对它们进行解码，并提供如实的 PDF 附件。

下载发票 INV-123456 的 PDF。

停用某人。 启用 scim 并设置 MALT_ALLOW_WRITES=true，使用 malt_user_lifecycle。它会停用而不是删除，这才是 Malt 实际支持的路径。

从我们的 Malt 组织中移除 jane.doe@acme.com。

文档

开发

npm ci
npm run typecheck
npm test
npm run build
npm run check-spec   # diff the live Malt spec against spec/malt-openapi.json

测试会模拟 fetch，绝不调用实时 API。

spec/malt-openapi.json 是 Malt 已发布文档的一个提交文件快照。一个每日工作流会对实时规范到与该快照的 diff，并在规范发生变化时打开 PR。Malt 一直将 info.version 保持在 0.0.1，因此该检查比较的是操作，而不是轻信版本号。

贡献力量

见 CONTRIBUTING.md。添加端点或工具集的说明见 docs/extending.md。

许可证

MIT

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • fintaro-mcp by fintaro-ai

    fintaro-mcpofficial

    fintaro-ai
    A
    license
    A
    quality
    D
    maintenance
    Enables MCP-capable agents to read Fintaro invoices and transactions, and upload receipts, via a scoped API key with PII-safe projections.
    6
    Apache 2.0

  • MCP Make.com Server

    Kikk79
    F
    license
    C
    quality
    C
    maintenance
    Provides full access to the Make.com API, enabling creation, modification, deletion, and execution of scenarios, as well as management of connections, webhooks, data stores, and organizations.
    21
    -

  • mcp-server-action1

    borgels
    A
    license
    A
    quality
    C
    maintenance
    Enables management of endpoint inventory, patching, and vulnerabilities through the Action1 REST API, with read-only access by default and optional write support for update approvals.
    15
    1
    Apache 2.0

  • Kontur.Elba MCP

    apo100l
    A
    license
    A
    quality
    B
    maintenance
    Enables managing Kontur.Elba data through the official Public API, including organizations, bank accounts, counterparties, products, documents, invoices, and public links via MCP tools.
    4
    3 npm
    MIT