apifm-admin-mcp

v26.5.7

5 days ago

MCP server for safely operating APIFM admin APIs through the apifm-admin SDK.

apifm-admin-mcp 是一个通过 apifm-admin SDK 调用 APIFM 后台接口的 MCP Server，可用于 Kiro、Cursor、Claude Code、Codex、Windsurf、Trae、Qoder 等支持 MCP 的 Agent。

密码、商户秘钥、X-Token、Basic Authentication 等敏感信息不要粘贴到聊天窗口。

本 MCP 通过 apifm_admin_start_auth 返回一个本地 127.0.0.1 授权页面。用户在浏览器里填写敏感信息，凭证只保存在当前 MCP 进程内存中，不会作为工具参数发送给大模型，也不会写入配置文件。

如果尚未授权就调用后台 API，apifm_admin_call 和 apifm_admin_find_and_call 会直接返回可见的 authUrl，Agent 应立即把这个 URL 展示给用户打开。

npm install -g apifm-admin-mcp

本包依赖 apifm-admin，但不会把 SDK 源码打包进 MCP。apifm-admin 后续升级新增的方法，会在运行时动态发现。

使用 npx：

{
  "mcpServers": {
    "apifm-admin": {
      "command": "npx",
      "args": ["apifm-admin-mcp"]
    }
  }
}

全局安装后：

{
  "mcpServers": {
    "apifm-admin": {
      "command": "apifm-admin-mcp"
    }
  }
}

授权页面分为“登录现有账号”和“注册新账号”，支持简体中文、繁体中文、英文切换，默认显示简体中文。

登录现有账号：

手机号登录：调用 loginAdminMobile，也就是“手机号码登录”方法。接口返回对象里的 token 会保存为后续请求头 X-Token。
邮箱登录：调用 loginAdminEmail，也就是“邮箱登录获取 X-TOKEN”方法。接口返回对象里的 token 会保存为后续请求头 X-Token。
直接填写 X-Token：不调用登录接口，直接保存填写的 X-Token，后续请求头写入 X-Token。
Basic Authentication：填写商户号和商户秘钥，MCP 会保存 Basic base64(商户号:商户秘钥)，后续请求只写入 Authorization: Basic ...。

注册新账号：

手机号登录和邮箱登录页面会显示图形验证码图片：

https://common.apifm.com/code?k=<随机数>

k 由页面自动生成，并通过隐藏字段提交。点击验证码图片会重新生成 k 并刷新图片。图形验证码输入框可留空，只有后端要求时再填写。

npm run check