MCP Server
Mafdet AI 的 MCP server 把只读账户工具带进 Claude Code、Claude Desktop、 Cursor、Codex CLI、OpenCode 等 MCP 客户端。它不做模型推理 —— 调用模型仍走 各工具原生的 OpenAI 兼容端点。本 server 只提供账户可见性和文档检索。
工具
| 工具 | 需要 Key | 作用 |
|---|---|---|
list_models | 否 | 列出模型(provider、访问档、API Surface、定价) |
search_docs | 否 | 搜索本文档(标题、URL、摘要) |
get_balance | 是 | 钱包余额、赠金、冻结、可用 |
get_usage_summary | 是 | 最近 N 天(1–90)的请求数、token、花费 |
get_subscription | 是 | 当前套餐、状态、周期、Playground 额度 |
所有工具均为只读 —— 无 key 管理、充值、退款或任何写操作。
配置
把 MAFDET_API_KEY 设为带 account:read scope 的 Key(在
API Keys 创建时勾选「允许本地 MCP 服务器读取本账户」)。
Key 是可选的:list_models 和 search_docs 无需 key。
Claude Code
claude mcp add mafdet --env MAFDET_API_KEY=sk-mafdet-live-... -- npx -y @mafdet/mcp
Claude Desktop / Cursor / 其他 MCP 客户端
{
"mcpServers": {
"mafdet": {
"command": "npx",
"args": ["-y", "@mafdet/mcp"],
"env": { "MAFDET_API_KEY": "sk-mafdet-live-..." }
}
}
}
Codex CLI(~/.codex/config.toml)
[mcp_servers.mafdet]
command = "npx"
args = ["-y", "@mafdet/mcp"]
env = { MAFDET_API_KEY = "sk-mafdet-live-..." }
安全
- 通过客户端的 env/secret 配置提供 Key,不要写在共享的命令行里。Key 只通过 HTTPS 发给 Mafdet AI,且只在账户工具上发送。
- 自动化场景固定主版本(
@mafdet/mcp@0)。 - 需要 Node.js 20+。