Quantix MCP

Quantix个人理财MCP服务器

用于Quantix个人金融API的MCP（模型上下文协议）服务器。将所有端点作为MCP工具公开，具有完整的输入验证和模块化架构。

特性

• 账户：管理银行账户、钱包、储蓄和投资。
• 分类：创建、列出、更新和删除财务类别（收入/支出）。
• 信用卡：管理卡片、查看/支付对账单和跟踪对账单状态。
• 交易：带过滤器（月、日期范围、帐户、类别、卡、类型、付款状态）、定期付款和分期付款处理的完整CRUD。
• 交易（已付款状态）：将交易标记为已付款或未付款。
• 设置：管理全局用户首选项（姓名、货币、语言）。
• 摘要：按月份或自定义日期范围列出的财务摘要——收入、支出、余额、信用卡总额和类别细分。
• 数据：导出和导入所有用户数据的完整备份。

所有工具输入均通过以下方式进行验证 佐德 符合OpenAPI规范的模式。

先决条件

• Node.js（v18或更高版本）
• npm
• 访问Quantix API和API密钥

安装

1. 克隆或导航到项目存储库。

1. 安装依赖项：

   npm install

配置

创建一个 .env 项目根目录中的文件：

QUANTIX_API_URL=https://api.quantix.example.com
QUANTIX_API_KEY=your_api_key_here
MCPPORT=3001

建设项目

npm run build

编译后的输出将在 dist 目录。

用法

快速入门（npx）

npx quantix-mcp

确保环境变量(QUANTIX_API_URL, QUANTIX_API_KEY)设置在您的环境中。

发展

npm run dev

生产

npm start

MCP检查员（建议用于测试）

1. 构建项目：

   npm run build

1. 运行检查器：

   npx @modelcontextprotocol/inspector node dist/index.js

1. 打开提供的URL与您的服务器进行交互。

暴露的MCP工具

看 openapi.yaml 在项目根目录下查看完整的端点和模式详细信息。

使用Claude Desktop进行设置

1. 找到您的Claude Desktop配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加服务器配置：

使用npx（推荐）：

   {
     "mcpServers": {
       "quantix": {
         "command": "npx",
         "args": ["-y", "quantix-mcp"],
         "env": {
           "QUANTIX_API_URL": "https://api.quantix.example.com",
           "QUANTIX_API_KEY": "your_api_key_here"
         }
       }
     }
   }

使用本地构建（适用于开发人员）：

   {
     "mcpServers": {
       "quantix": {
         "command": "node",
         "args": ["/absolute/path/to/dist/index.js"],
         "env": {
           "QUANTIX_API_URL": "https://api.quantix.example.com",
           "QUANTIX_API_KEY": "your_api_key_here"
         }
       }
     }
   }

测试

npm test

许可证

国际学生委员会