Maxio API Protocol - Claude Model Context Protocol (MCP)
2025.04.24
0
TypeScript财务管理系统API协议Claude集成金融服务
Maxio API Protocol - Claude Model Context Protocol (MCP) 是一个用于与Maxio（原SaaSOatics）财务管理系统交互的协议。它允许用户通过Claude模型执行各种财务操作，包括客户和合同管理、订阅创建与跟踪、发票生成和付款记录、收入与财务指标分析等。
View on GitHub
Overview
基本能力
产品定位
Maxio-mcp是一个财务管理系统接口协议，专门设计用于通过Claude模型与Maxio财务系统进行交互。
核心功能
- 客户和合同管理
- 订阅创建与跟踪
- 发票生成和付款记录
- 收入与财务指标分析
适用场景
- 企业财务自动化管理
- 客户关系与合同管理
- 收入分析与报告生成
- 发票与付款流程自动化
工具列表
- Docker容器：用于部署和运行MCP服务
- PowerShell脚本：Windows用户安装选项
- 交互式安装脚本：引导用户完成配置
- Claude桌面应用集成：直接与Claude模型集成
常见问题解答
- 端口冲突：可更改端口映射解决
- 连接问题：确保Docker容器有网络访问权限
- 自动关闭问题：设置AUTO_SHUTDOWN=false
- 高CPU使用率：更新到最新版本解决
- 网络工具问题：提供多种调试命令检查网络连接
使用教程
使用依赖
- 需要安装Docker环境
安装教程
一键安装
docker run -d --name maxio-mcp -p 3000:3000 \
-e MAXIO_BASE_URL="https://your-instance.saasoptics.com" \
-e MAXIO_API_TOKEN="your-api-token-here" \
-e AUTO_SHUTDOWN="false" \
--restart unless-stopped \
ghcr.io/banner-dev/maxio-mcp:latest
PowerShell安装
docker run -d --name maxio-mcp -p 3000:3000 `
-e MAXIO_BASE_URL="https://your-instance.saasoptics.com" `
-e MAXIO_API_TOKEN="your-api-token-here" `
-e AUTO_SHUTDOWN="false" `
--restart unless-stopped `
ghcr.io/banner-dev/maxio-mcp:latest
交互式安装
curl -s https://raw.githubusercontent.com/banner-dev/maxio-mcp/main/install.sh | bash
调试方式
- 启动容器：
docker start maxio-mcp - 停止容器：
docker stop maxio-mcp - 查看日志：
docker logs maxio-mcp - 移除容器：
docker rm maxio-mcp - 检查容器健康状态：
docker inspect maxio-mcp | grep Health - 手动测试API端点：
curl -H "Authorization: Bearer your-api-token" http://localhost:3000/health