关于 Fixpayment
Fixpayment 是连接 FixPayment 债权人门户的 FastMCP 服务,供支持 MCP 的助手使用。它提供账户操作和报表工具,并根据 API 密钥及方案控制访问权限。
主要功能
- 01创建单个或批量账户
- 02更新账户状态
- 03添加账户文档
- 04查看账户摘要和列表
- 05生成账户、付款、结算和绩效报表
- 06按 API 密钥和方案限制工具权限
适用场景
- 01通过 MCP 客户端创建债权人账户
- 02更新账户状态并添加文档
- 03查看付款和结算报表
- 04按方案限制可用操作
MCP 相关
该 FastMCP 服务向 MCP 客户端提供 FixPayment 账户、文档和报表操作。每个工具都要求 API 密钥,并据此关联债权人及方案。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
http://fixpayment.org:8000一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http fixpayment_mcp http://fixpayment.org:8000Cursor.cursor/mcp.json
{"mcpServers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"fixpayment_mcp":{"type":"http","url":"http://fixpayment.org:8000"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"fixpayment_mcp":{"serverUrl":"http://fixpayment.org:8000"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
全部服务地址
Streamable HTTP
http://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_HOST | PostgreSQL 主机 | localhost |
FIXPAYMENT_DB_PORT | PostgreSQL 端口 | 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)。
方案与工具
| 工具 | basic | reports | full |
|---|---|---|---|
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_atfixpayment_accounts— 账户表fixpayment_payments— 付款表fixpayment_settlements— 结算表fixpayment_account_documents— 文档附件
如需申请 API 密钥或升级方案,请发送邮件至 [email protected]。
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。