Agent Payment MCP

🚀 Agent Payment MCP

Agent Payment MCP 是一款一键安装工具，可将高级 AI 工具添加到 Claude Desktop、Cursor、VS Code 等 AI 编码助手之中，为开发者提供强大且便捷的功能支持。

🚀 快速开始

步骤 1：获取 API 密钥

访问 agentpmt.com 并创建账户，以获取：

• API 密钥：用于验证您的请求。
• 预算密钥：用于控制支出限额。

步骤 2：安装 MCP 服务器

您可以选择以下偏好的安装方法：

选项 A：NPM（推荐给开发者）

通过 npm 进行安装（适用于 Windows、macOS 和 Linux）：

npm install -g @agentpmt/mcp-router

然后运行配置向导：

agentpmt-install

向导将执行以下操作：

1. 检测您的 Claude Desktop 安装情况。
2. 提示输入服务器名称（默认值：agentpmt）。
3. 提示输入您的 API 密钥和预算密钥。
4. 自动配置 Claude Desktop。
5. 完成！只需重启 Claude Desktop 即可。

在 NPM 上查看 →

选项 B：GUI 安装程序

下载适用于您操作系统的安装程序：

• Windows：agent-payment-installer-windows-amd64.exe
• macOS（Apple Silicon - M1/M2/M3）：agent-payment-installer-macos-arm64
• macOS（Intel）：agent-payment-installer-macos-intel
• Linux：agent-payment-installer-linux-amd64

然后：

1. 双击安装程序：将自动打开一个浏览器窗口。
2. 输入步骤 1 中的 API 凭证。
3. 点击“安装”：安装将在数秒内完成。
4. 重启 Claude Desktop。

选项 C：单行 shell 脚本安装

Windows（PowerShell）：

irm https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/install-windows.ps1 | iex

macOS：

curl -fsSL https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/install-macos.sh | bash

Linux：

curl -fsSL https://github.com/Apoth3osis-ai/agent-payment-mcp/releases/latest/download/install-linux.sh | bash

选项 D：手动安装

1. 从 最新版本 下载适用于您平台的路由器二进制文件：

   • Windows：agent-payment-router-windows-amd64.exe
   • macOS Intel：agent-payment-router-darwin-amd64
   • macOS ARM：agent-payment-router-darwin-arm64
   • Linux AMD64：agent-payment-router-linux-amd64
   • Linux ARM64：agent-payment-router-linux-arm64

2. 将其放置在 ~/.agent-payment-router/（在 Windows 上为 %USERPROFILE%\.agent-payment-router\）。

3. 添加到您的 AI 工具的 MCP 配置中（例如，Claude Desktop 的 claude_desktop_config.json）：

   {
     "mcpServers": {
       "agentpmt": {
         "command": "/path/to/agent-payment-router",
         "args": [],
         "env": {
           "x-api-key": "YOUR_API_KEY",
           "x-budget-key": "YOUR_BUDGET_KEY",
           "x-instance-metadata": "{\"client\":\"claude_desktop\",\"platform\":\"windows\"}"
         }
       }
     }
   }
   

4. 重启您的 AI 工具

完成以上步骤后，您已批准的工具现在可在您的 AI 助手使用。

✨ 主要特性

Agent Payment MCP 可让您的 AI 编码助手（如 Claude Desktop）访问以下强大工具：

• 🧮 智能数学：符号微积分、数值计算、统计。
• 📊 合成数据：生成逼真的测试数据（人员、公司、家庭、电子商务等）。
• 🔧 文本实用工具：30 多种文本转换工具（大小写转换、格式化等）。
• 🐍 Python 隔离：安全运行具有冲突库版本的 Python 代码。
• 🌐 网络工具：WebSocket、MQTT、SMTP、Tor、IPFS 访问。
• 💾 不可变存储：TWINE 加密时间戳和去中心化存储。
• 🎲 随机数据：用于密钥和令牌的加密安全随机字节。

这些工具采用按使用付费的模式，定价透明。可用工具会根据您的预算批准情况而有所不同。

📦 支持的 AI 工具

MCP 路由器可与任何 MCP 兼容的客户端配合使用！ 上述自动安装程序会自动配置 Claude Desktop，但您也可以手动配置其他任何 MCP 客户端。

自动安装支持：

• ✅ Claude Desktop：完全自动化的安装和配置。

手动配置（任何 MCP 客户端）：

• ✅ Cursor：由 AI 驱动的 VS Code 分支。
• ✅ VS Code：搭配 GitHub Copilot 或类似扩展使用。
• ✅ Windsurf：Codeium 的 AI IDE。
• ✅ Zed：具有 AI 功能的现代代码编辑器。
• ✅ JetBrains IDEs：IntelliJ、PyCharm 等。
• ✅ 任何其他 MCP 兼容的客户端

如何配置其他 MCP 客户端

该路由器是一个标准的 MCP 服务器。要将其与任何 MCP 客户端配合使用，请按以下步骤操作：

1. 安装二进制文件（使用 NPM、shell 脚本或手动下载）。
2. 找到您客户端的 MCP 配置文件。
3. 添加以下配置：

{
  "mcpServers": {
    "agentpmt": {
      "command": "C:\\Users\\YOUR_USERNAME\\.agent-payment-router\\agent-payment-router.exe",
      "args": [],
      "env": {
        "x-api-key": "YOUR_API_KEY",
        "x-budget-key": "YOUR_BUDGET_KEY",
        "x-instance-metadata": "{\"client\":\"YOUR_CLIENT_NAME\",\"platform\":\"YOUR_PLATFORM\"}"
      }
    }
  }
}

替换内容如下：

• YOUR_USERNAME：您的系统用户名。
• YOUR_API_KEY：您的 AgentPMT API 密钥。
• YOUR_BUDGET_KEY：您的 AgentPMT 预算密钥。
• YOUR_CLIENT_NAME：例如，"cursor"、"vscode"、"zed" 等。
• YOUR_PLATFORM："windows"、"darwin"（macOS）或 "linux"。

注意：某些客户端使用不同的配置键（例如，VS Code 使用 "servers" 而不是 "mcpServers"，Zed 使用 "context_servers"）。请查看您客户端的 MCP 文档。

🔧 故障排除

Windows：“Windows Defender 阻止了此应用”

对于未签名的可执行文件，出现此情况是正常的。您可以通过以下两种方式解决：

选项 1：添加排除项（自动） 安装程序会尝试自动执行此操作，但如果失败，请按以下步骤操作：

1. 打开 Windows 安全中心 → 病毒和威胁防护。
2. 点击 管理设置。
3. 滚动到 排除项 → 添加或删除排除项。
4. 点击 添加排除项 → 文件夹。
5. 添加：%USERPROFILE%\.agent-payment

选项 2：仍然运行（一次性） 当 Windows Defender 发出警告时：

1. 点击 更多信息。
2. 点击 仍然运行。

工具未显示

1. 完全重启您的 AI 工具：关闭并重新打开。
2. 检查 MCP 服务器状态：
   • Claude Desktop：在 %APPDATA%\Claude\logs\（Windows）或 ~/Library/Application Support/Claude/logs/（macOS）中打开日志。
   • 查找 [agent-payment] 条目。
3. 验证安装：
   • 检查 ~/.agent-payment/agent-payment-server 是否存在。
   • 检查 ~/.agent-payment/config.json 是否包含您的 API 密钥。

仍然存在问题？

• 检查日志：大多数 AI 工具都有 MCP 日志，显示连接错误。
• 验证 API 密钥：确保它们复制正确（无多余空格）。
• 检查网络：某些工具需要互联网连接才能正常工作。
• 提交问题：GitHub 问题

📚 安装内容

安装程序将创建以下内容：

~/.agent-payment-router/
└── agent-payment-router     # MCP 服务器二进制文件（约 6 MB）

注意：API 凭证存储在您的 AI 助手的配置文件中，而不是单独的 config.json 文件。

安装程序还会更新您的 AI 工具的 MCP 配置文件。

🔒 安全与隐私

• ✅ API 密钥本地存储：绝不会发送给第三方。
• ✅ 开源：所有代码均可在 GitHub 上进行审计。
• ✅ 无遥测：除 API 计费外，我们不会跟踪使用情况。
• ✅ 加密通信：所有 API 调用均使用 HTTPS。
• ✅ 预算控制：通过预算密钥设置支出限额。

🗑️ 卸载

要移除 Agent Payment MCP，请按以下步骤操作：

1. 移除 MCP 服务器：

   rm -rf ~/.agent-payment-router
   

2. 从 AI 工具配置中移除：

   • Claude Desktop：编辑 claude_desktop_config.json 并移除 agentpmt 部分。
   • Cursor：编辑 ~/.cursor/mcp.json 并移除 agentpmt 部分。
   • VS Code：编辑设置中的 mcp.json 并移除 agentpmt 部分。
   • 其他工具：对每个工具执行类似的操作。

3. 重启您的 AI 工具

📖 更多帮助

• 📖 文档：安装指南
• 🐛 问题反馈：GitHub 问题
• 🌐 网站：agentpmt.com

💻 开发者相关

如果您想贡献代码或从源代码进行构建，请查看 docs/development/ 中的技术文档。

📄 许可证

本项目采用 MIT 许可证，请参阅 LICENSE 了解详细信息。