金融服务MCP服务器

Coverflex MCP服务器是一个允许AI代理与Coverflex金融服务交互的工具,提供用户认证、福利查询、卡片管理等功能。

  • by tembleking
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 tembleking/coverflex-mcp

使用说明

Coverflex MCP服务器

此存储库包含一个CLI和MCP服务器,用于与Coverflex交互。

概述

该项目是一个MCP服务器,允许AI代理与Coverflex服务进行交互。

它包括一个主要用于对用户进行身份验证的命令行界面(CLI),然后启用MCP服务器中可用的工具。

可用工具

MCP服务器根据用户的身份验证状态公开不同的工具。

注销时

  • is_logged_in:检查用户当前是否已登录。
  • request_otp:通过请求向用户手机发送OTP来启动登录过程。
  • trust_device_via_otp:提交通过短信收到的一次性密码(OTP),以完成登录过程并信任设备。

登录时

  • is_logged_in:检查用户当前是否已登录。
  • get_benefits:检索用户权益。
  • get_cards:检索用户卡。
  • get_company:检索公司信息。
  • get_compensation:检索用户补偿摘要。
  • get_family:检索用户家庭成员。
  • get_operations:使用可选的分页和筛选检索用户操作。

入门指南

先决条件

  • 达到1.21或更高
  • Nix(可选,用于开发环境)

用法

运行应用程序有两种主要方法。

使用 go run (推荐)

要在没有本地克隆的情况下直接从远程存储库运行应用程序,请执行以下操作:

# To start the MCP server
go run github.com/tembleking/coverflex-mcp/cmd/server@latest

# To log in (note the -- separator)
go run github.com/tembleking/coverflex-mcp/cmd/server@latest -- login --user <your-email> --pass <your-password>

从源头构建

如果你更喜欢自己构建二进制文件:

  1. 克隆存储库:

    git clone https://github.com/tembleking/coverflex-mcp.git
    cd coverflex-mcp
    
  2. 构建二进制文件:

    go build -o coverflex-mcp ./cmd/server
    

这将创建一个 coverflex-mcp 可在当前目录中执行。

认证

要使用MCP服务器,您首先需要登录您的Coverflex帐户。如果你从源代码构建,你会运行 ./coverflex-mcp。如果您正在使用 go run,您将使用上面部分中的命令。

使用内置二进制文件的示例:

./coverflex-mcp login --user <your-email> --pass <your-password>

如果启用了双因素身份验证(2FA),您将在手机上收到一个OTP。使用以下命令重新运行该命令 --otp 旗帜。

一旦通过身份验证,该工具将保存您的令牌以供将来使用。

MCP服务器

要启动MCP服务器,请运行所选方法的相应命令(go run 或构建的二进制文件)。

使用内置二进制文件的示例:

./coverflex-mcp

服务器将启动并监听来自MCP客户端的请求。

许可证

此项目根据Apache 2.0许可证获得许可。看 许可证 文件以获取详细信息。