金融模拟服务器

fi mcp开发

Fi MCP服务器的最低版本，可用于黑客马拉松。该项目提供了一个轻量级的模拟服务器，用于黑客马拉松、演示和开发，用虚拟数据和简化的身份验证模拟生产Fi MCP服务器的核心功能。

目的

• fi mcp开发 是为那些希望在不访问真实用户数据或生产系统的情况下尝试Fi-MCP API的黑客马拉松参与者和开发人员设计的。
• 它提供虚拟财务数据，并使用虚拟身份验证流程，使其在非生产环境中安全易用。

特性

• 模拟Fi-MCP API：实现净值、信用报告、EPF详细信息、共同基金交易和银行交易的端点。
• 虚拟数据：所有响应都来自静态JSON文件 test_data_dir/，代表各种用户场景。
• 伪身份验证：使用允许的电话号码（目录名）的简单登录流程 test_data_dir/).没有真正的OTP或用户验证。
• 黑客马拉松准备就绪：没有真正的集成，没有敏感数据，易于重置或扩展。

目录结构

• main.go --入口点，设置服务器和端点。
• middlewares/auth.go --实现虚拟身份验证和会话管理。
• test_data_dir/ --包含以允许的电话号码命名的目录。每个目录保存不同API响应的JSON文件（例如。， fetch_net_worth.json).
• static/ --登录和登录成功页面的HTML文件。

虚拟数据场景

虚拟数据涵盖了各种用户状态。示例场景：

• 所有关联资产：银行、EPF、印度股票、美国股票、信用报告、大型或小型共同基金投资组合。
• 除银行账户外的所有资产：没有银行账户，但有其他资产。
• 多家银行和UAN：多个银行账户和EPF UAN，部分交易覆盖。
• 无关联资产：只有储蓄账户余额。
• 无信用报告：除信用报告外的所有资产。

测试数据场景

示例：虚拟数据文件

样品 fetch_net_worth.json （为简洁起见截断）：

{
  "netWorthResponse": {
    "assetValues": [
      {"netWorthAttribute": "ASSET_TYPE_MUTUAL_FUND", "value": {"currencyCode": "INR", "units": "84642"}},
      {"netWorthAttribute": "ASSET_TYPE_EPF", "value": {"currencyCode": "INR", "units": "211111"}}
    ],
    "liabilityValues": [
      {"netWorthAttribute": "LIABILITY_TYPE_VEHICLE_LOAN", "value": {"currencyCode": "INR", "units": "5000"}}
    ],
    "totalNetWorthValue": {"currencyCode": "INR", "units": "658305"}
  }
}

身份验证流程

• 当调用工具/API时，服务器将检查有效的会话。
• 如果未通过身份验证，系统会提示用户通过网页登录(/mockWebPage?sessionId=...).
• 输入任何允许的电话号码（请参阅中的目录 test_data_dir/).OTP未验证。
• 成功登录后，会话将在服务器运行期间存储在内存中。

运行服务器

先决条件

• 转到1.23或更高版本(安装说明)

安装依赖项

go mod tidy

启动服务器

FI_MCP_PORT=8080 go run .

服务器将于启动 http://localhost:8080.

用法

• 按照此说明进行操作 指南 设置客户端
• 将url替换为本地运行的服务器，例如： http://localhost:8080/mcp/stream
• 当系统提示登录时，使用上述电话号码之一
• Otp/密码可以是网页上的任何东西

简单的curl客户端

curl -X POST -H "Content-Type: application/json" -H "Mcp-Session-Id: mcp-session-594e48ea-fea1-40ef-8c52-7552dd9272af" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"fetch_bank_transactions","arguments":{}}}' http://localhost:8080/mcp/stream

如果你运行一次，你会得到 login_url 作为响应，登录后再次运行它将为您提供数据