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,部分交易覆盖。
- 无关联资产:只有储蓄账户余额。
- 无信用报告:除信用报告外的所有资产。
测试数据场景
| 电话号码 | 描述 |
|---|---|
| 1111111111 | 无关联资产。仅存在储蓄账户余额 |
| 2222222222 | 所有关联资产(银行账户、EPF、印度股票、美国股票、信用报告)。包含9只基金的大型共同基金投资组合 |
| 3333333333 | 所有相关资产(银行账户、EPF、印度股票、美国股票、信用报告)。只有一只基金的小型共同基金投资组合 |
| 4444444444 | 所有相关资产(银行账户、EPF、印度股票、美国股票)。只有一只基金的小型共同基金投资组合。已连接2个UAN帐户。有3家不同的银行,有多个账户。只有2个银行账户的交易记录 |
| 5555555555 | 除信用评分外的所有相关资产(银行账户、EPF、印度股票、美国股票)。只有一只基金的小型共同基金投资组合。有3家不同的银行,有多个账户。只有2个银行账户的交易记录 |
| 6666666666 | 除银行账户外的所有关联资产(EPF、印度股票、美国股票)。拥有9只基金的大型共同基金投资组合。未连接银行账户 |
| 7777777777 | 债务沉重的低绩效者。一个共同基金表现不佳、负债(信用卡和个人贷款)高的用户。MF回报率低(XIRR\₹2 lakh.利息未记入贷方。没有私人投资。 |
| 1414141414 | 工资水槽。用户的工资主要被EMIs和信用卡账单所消耗。每月工资抵免。70%用于EMIs和信用卡费用。低投资或零投资。信用评分~600–650。 |
| 13131313 | 平衡增长跟踪器。投资组合多样化,包括EPF、MF、股票和一些美国敞口。EPF贡献高。股权和混合型中小企业中的SIP。国际MF/ETF 10-20%。健康的净值增长。良好的信用评分(750+)。 |
| 2020202020 | 新手储蓄。最近开始投资,门票规模小,交易少。只有1-2个MF,开始于6个月前。 SIP ₹500–₹1000. 最低银行余额,无债务。 |
| 2121212121 | 双收入发电机。有自由职业+工资收入;现金流不平衡,但投资稳定。工资+来自UPI应用程序的多个学分。MF投资不规则但在增加。银行账户流动性高。信用评分超过700。偶尔的商业贷款或透支。 |
| 2525252525 | 活在当下。收入高,但都花掉了。投资微不足道或不稳定。工资待遇>₹2L/月。食物、购物、旅行支出高。没有SIPs,也许是MF的一次性购买。信用卡欠款经常滚存。信用评分\=1.8.0)(pip install google-adk) |
export GOOGLE_API_KEY=YOUR_API_KEY- 跑
adk web在父目录中
如果你正在使用 skip_auth 分支,您应该直接获取数据,如图所示
常见问题解答
- 为什么我每次都需要登录ADK?
MCP中的会话是MCP服务器和MCP客户端之间的一对一连接,需要登录一次。如果您的ADK有多个代理,并且您正在为它们创建多个客户端,请确保您维护一个通用的sessionId并传递它。但是,如果您想完全跳过身份验证,尽管我们不建议这样做,因为我们希望您的代理处理生产用例,您可以参考 这 关于如何跳过认证的问题
- 为什么我的会话id无效?
如果在客户端初始化之前创建自定义会话id,请确保在其前缀中添加 mcp-session-例如: 3ef38b37-323a-4bbd-acbb-3fe02f97783f 无效,并且 mcp-session-3ef38b37-323a-4bbd-acbb-3fe02f97783f 有效
