AI导哈

金融账户协议服务器

PEX MCP服务器是一个模型上下文协议服务器，提供对PEX卡外部API的访问，使AI助手能够与PEX商业账户、卡片、交易等进行交互。

  • by pexcard
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 pexcard/mcp

使用说明

PEX MCP服务器

一种模型上下文协议（MCP）服务器，提供对 PEX卡外部API.使用此服务器让像Claude这样的AI助手与您的PEX业务帐户、卡、交易等进行交互。

获取您的PEX API代币

要使用PEX MCP服务器，您需要一个PEX API令牌。按照以下步骤生成一个：

  1. 登录到 PEX仪表板 使用您的凭据。
  2. 导航至 简介 > 授权应用程序 （或直接前往 /account/authorized-apps).
  3. 查找 PEX MCP服务器 应用程序并单击它。
  4. 点击 生成令牌 并复制令牌值。

注： 确保API令牌的安全。不要将其提交给版本控制或公开共享。

配置

设置以下环境变量：

变量 必填 描述
PEX_API_URL 是 PEX API基本URL（例如。， https://coreapi.pexcard.com/v4)
PEX_API_TOKEN 是 您的PEX API代币（请参阅 获取您的PEX API代币)

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "pex": {
      "command": "npx",
      "args": ["-y", "@pexcard_engineering/mcp"],
      "env": {
        "PEX_API_URL": "https://coreapi.pexcard.com/v4",
        "PEX_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

配置文件位置

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

使用克劳德代码（CLI）

使用Claude Code CLI添加MCP服务器：

claude mcp add pex -e PEX_API_URL=https://coreapi.pexcard.com/v4 -e PEX_API_TOKEN=your-api-token-here -- npx -y @pexcard_engineering/mcp

或者手动将其添加到您的 .claude/settings.json:

{
  "mcpServers": {
    "pex": {
      "command": "npx",
      "args": ["-y", "@pexcard_engineering/mcp"],
      "env": {
        "PEX_API_URL": "https://coreapi.pexcard.com/v4",
        "PEX_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

使用GitHub Copilot

VS Code

将以下内容添加到您的VS代码设置中(.vscode/settings.json 或用户设置）：

{
  "github.copilot.chat.mcpServers": {
    "pex": {
      "command": "npx",
      "args": ["-y", "@pexcard_engineering/mcp"],
      "env": {
        "PEX_API_URL": "https://coreapi.pexcard.com/v4",
        "PEX_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

或者，创建一个 .mcp.json 项目根目录中的文件：

{
  "servers": {
    "pex": {
      "command": "npx",
      "args": ["-y", "@pexcard_engineering/mcp"],
      "env": {
        "PEX_API_URL": "https://coreapi.pexcard.com/v4",
        "PEX_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

提示： 当使用 .mcp.json，将其添加到您的 .gitignore 如果它包含您的实际令牌，或者使用环境变量引用将秘密排除在源代码控制之外。

可用工具（共72个）

商务（12个工具）

工具 说明
pex_get_business_profile 获取业务配置文件详细信息，包括姓名、地址、电话和状态
pex_get_business_balance 获取企业账户余额
pex_get_business_admins 获取所有业务管理员的列表
pex_get_business_admin 按ID获取特定业务管理员
pex_get_business_tags 获取所有业务标签
pex_get_business_tag 通过ID获取特定的业务标签
pex_get_business_linked 获取关联企业
pex_get_business_bank_account 获取商业银行账户详细信息
pex_get_business_one_time_transfer 获取业务一次性转账详细信息
pex_get_business_my_profile 获取当前用户的业务配置文件
pex_get_business_billing 获取特定月份的业务账单信息
pex_get_business_settings 获取业务设置

卡片（7个工具）

工具 说明
pex_get_card 通过卡帐户ID获取卡配置文件/详细信息
pex_get_card_spend_rules 获取特定卡的消费规则
pex_get_card_advanced_spend_rules 获取特定卡的高级消费规则
pex_get_card_load_limit_remaining 获取特定卡的剩余卡负载限制
pex_get_card_scheduled_funding_rules 获取特定卡的预定资金规则
pex_get_card_order 按ID获取特定卡订单
pex_get_card_orders 在可选日期范围内获取卡订单

交易（10种工具）

工具 说明
pex_get_business_transactions 使用筛选器获取分页的业务交易
pex_get_business_transaction 按ID获取特定业务交易
pex_get_cardholder_transactions 获取持卡人交易的分页
pex_get_cardholder_transaction 通过ID获取特定持卡人交易
pex_get_cardholder_purchases 获取持卡人购买的分页
pex_get_cardholder_purchase 通过ID获取特定持卡人购买
pex_get_cardholder_declines 获取持卡人拒绝的分页
pex_get_transaction_attachments 获取交易的所有附件
pex_get_transaction_attachment 获取交易的特定附件
pex_get_transaction_tags 获取特定交易的标签

账户详细信息（10个工具）

工具 说明
pex_get_account_details 通过ID获取持卡人账户详细信息
pex_get_advanced_account_details 通过ID获取高级持卡人账户详细信息
pex_get_all_account_details 获取该业务的所有持卡人账户详细信息
pex_get_account_balance 获取特定持卡人的账户余额
pex_get_account_remaining_limits 获取持卡人的剩余消费限额
pex_get_network_transactions 为企业获取网络交易
pex_get_cardholder_network_transactions 获取特定持卡人的网络交易
pex_get_transaction_detail 获取特定交易的交易详细信息
pex_get_transaction_details 获取业务的交易详细信息
pex_get_all_cardholder_transactions 获取日期范围内的所有持卡人交易

支出规则集（7个工具）

工具 说明
pex_list_spending_rulesets 获取企业的所有支出规则集
pex_get_spending_ruleset 按ID获取特定的支出规则集
pex_get_spending_ruleset_cards 获取分配给支出规则集的卡片
pex_list_advanced_spending_rulesets 获取所有高级支出规则集
pex_get_advanced_spending_ruleset 按ID获取特定的高级支出规则集
pex_get_advanced_spending_ruleset_cards 获取分配给高级消费规则集的卡片
pex_get_mcc_categories 获取商户类别代码（MCC）类别

账单（4个工具）

工具 说明
pex_get_bill 按账单ID获取账单付款详细信息
pex_get_bill_payments 获取特定账单的付款
pex_get_bill_payment_request 通过ID获取特定的账单付款请求
pex_search_bills 使用可选过滤器搜索账单

供应商（3个工具）

工具 说明
pex_list_vendors 使用过滤器获取供应商的分页列表
pex_get_vendor 按ID获取特定供应商
pex_get_vendor_card_order 按订单ID获取供应商卡订单详细信息

付款（3种工具）

工具 说明
pex_get_payments 获取业务付款的分页列表
pex_get_payment_transfer 通过ID获取特定的付款转账
pex_get_payment_request 通过ID获取特定的付款请求

信用和发票（4个工具）

工具 说明
pex_get_credit_lines 获取企业的信用额度信息
pex_get_invoices 从给定日期开始获取业务发票
pex_get_invoice_allocations 获取特定发票的分配
pex_get_invoice_payments 获取特定发票的付款

组（2个工具）

工具 说明
pex_list_groups 获取该业务的所有持卡人组
pex_get_group_cardholders 获取属于特定组的持卡人

代币（6个工具）

工具 说明
pex_get_current_token 获取当前身份验证令牌的详细信息
pex_list_tokens 获取已验证用户的所有令牌
pex_get_auth_tokens 获取已验证用户的基本令牌详细信息
pex_get_token_provisioning_mode 获取业务令牌配置模式
pex_get_cardholder_provisioning_mode 获取持卡人的令牌配置模式
pex_get_issued_tokens 为特定持卡人获取已发行的代币

回调（3个工具）

工具 说明
pex_get_callback_types 获取可用的回调订阅类型
pex_list_callback_subscriptions 获取业务的所有回调订阅
pex_get_callback_subscription 按ID获取特定的回调订阅

合作伙伴（1个工具）

工具 说明
pex_get_partner 获取当前业务的合作伙伴详细信息

特性

  • API全面覆盖：72个工具，涵盖PEX External API的所有GET端点
  • 输入验证：所有参数均已验证，并显示明确的错误消息
  • 重试逻辑：对502/503/504错误进行指数回退的自动重试
  • 请求超时：30秒超时可防止挂起请求
  • 结构化日志：JSON日志记录到stderr进行调试（stdout保留给MCP）
  • 丰富的文档：所有工具参数都包括描述、有效值和约束

示例查询

连接后，您可以问Claude以下问题：

  • “我的企业账户余额是多少？”
  • “显示上周超过100美元的所有交易”
  • “列出所有卡及其消费限额”
  • “12345卡的消费规则是什么？”
  • “显示待付款项”

许可证

麻省理工学院

相关 MCP