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 瞭解詳細信息。