mcpField
F
Fixpayment

Fixpayment

远程服务
github.com/prmail金融数据032 周前更新
代码仓库

关于 Fixpayment

Fixpayment 是连接 FixPayment 债权人门户的 FastMCP 服务,供支持 MCP 的助手使用。它提供账户操作和报表工具,并根据 API 密钥及方案控制访问权限。

主要功能

  1. 01创建单个或批量账户
  2. 02更新账户状态
  3. 03添加账户文档
  4. 04查看账户摘要和列表
  5. 05生成账户、付款、结算和绩效报表
  6. 06按 API 密钥和方案限制工具权限

适用场景

  1. 01通过 MCP 客户端创建债权人账户
  2. 02更新账户状态并添加文档
  3. 03查看付款和结算报表
  4. 04按方案限制可用操作

MCP 相关

该 FastMCP 服务向 MCP 客户端提供 FixPayment 账户、文档和报表操作。每个工具都要求 API 密钥,并据此关联债权人及方案。

配置

远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。

服务地址http://fixpayment.org:8000
一键复制安装命令
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

全部服务地址
Streamable HTTPhttp://fixpayment.org:8000需要授权

工具

详细介绍

FixPayment MCP 服务

一个基于 FastMCP 构建的服务,为 FixPayment 门户提供面向债权方的 API。
将任意支持 MCP 的 AI 助手(例如 Claude)连接到你的 FixPayment 账户,即可用通俗易懂的语言创建账户、更新状态并运行报告。

  • MCP 服务 URL:http://fixpayment.org:8000
  • 文档:https://fixpayment.org/mcp/fixpayment-mcp.html
  • 支持:[email protected]

快速入门

# 1. Clone & install dependencies
pip install -r requirements.txt

# 2. Configure credentials
cp .env.example .env
# Edit .env and set FIXPAYMENT_DB_* variables

# 3. Run the server
python -m mcp.server
# or via FastMCP CLI:
fastmcp run mcp/server.py:mcp

环境变量

变量描述默认值
FIXPAYMENT_DB_HOSTPostgreSQL 主机localhost
FIXPAYMENT_DB_PORTPostgreSQL 端口54432
FIXPAYMENT_DB_NAME数据库名称fixpayment_db
FIXPAYMENT_DB_USER数据库用户fixpayment_user
FIXPAYMENT_DB_PASS数据库密码(必填)
FIXPAYMENT_UPLOAD_PATH上传根目录/var/www/fixpayment/uploads/

身份验证模式

每个 MCP 工具都需要一个 api_key 参数。
该密钥在 mcp_api_keys 表中关联一个 creditor_id 和一个 plan(basic、reports 或 full)。


方案与工具

工具basicreportsfull
ping✓✓✓
get_plan_info✓✓✓
get_account_summary✓✓✓
list_accounts_basic✓✓✓
validate_account_payload✓✓✓
accounts_report✓✓
payments_report✓✓
settlements_report✓✓
performance_report✓✓
create_account✓
bulk_create_accounts✓
update_account_status✓
add_account_document✓

项目结构

fixpayments/
├── mcp/
│   ├── __init__.py
│   ├── server.py          # FastMCP instance + entrypoint
│   ├── db.py              # DB connection helper
│   ├── auth.py            # API key validation
│   └── tools/
│       ├── __init__.py
│       ├── basic.py       # Basic plan tools (5 tools)
│       ├── reports.py     # Reports plan tools (4 tools)
│       └── accounts.py    # Full plan tools (4 tools)
├── docs/
│   └── fixpayment-mcp.html
├── .env.example
├── .gitignore
├── requirements.txt
└── README.md

数据库架构(必需的表)

  • mcp_api_keys — api_key、creditor_id、plan、active、expires_at
  • fixpayment_accounts — 账户表
  • fixpayment_payments — 付款表
  • fixpayment_settlements — 结算表
  • fixpayment_account_documents — 文档附件

如需申请 API 密钥或升级方案,请发送邮件至 [email protected]。

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。