项目简介

"Can I Haz Houze?" 是一个先进的.NET Aspire驱动的房贷审批系统,它整合了文档管理、财务账本追踪、AI辅助分析以及客户关系管理等模块。核心亮点是其对 Model Context Protocol (MCP) 服务器的支持,允许与AI助手(如Claude Desktop)无缝集成,提供智能化的上下文服务。

主要功能点

  • AI助手集成: 通过MCP协议,支持AI助手直接访问系统功能,实现智能化的对话式交互。
  • 文档管理: 支持拖放上传文件,利用AI分析文档并自动提取元数据、建议智能标签,并能进行抵押文档验证(收入、信用、就业、评估)。
  • 账本服务: 追踪财务交易,提供房贷计算辅助功能,并与文档验证集成。
  • 抵押审批: 实现自动化审批流程,包括文档验证和AI辅助决策。
  • 客户关系管理 (CRM): 管理客户投诉和支持工作流,支持评论线程和审批流程。
  • AI Agent Workbench: 建立和管理基于Semantic Kernel的复杂AI代理,支持多轮对话、多模型选择和工具集成。
  • API 文档: 提供全面的OpenAPI规范和系统提示,方便集成到Azure AI Foundry等平台。
  • JSON-RPC 2.0 / WebSocket: MCP通信基于JSON-RPC 2.0,通过WebSocket实现实时通信。

安装步骤

  1. 克隆仓库:
    git clone https://github.com/abossard/can-i-haz-houze.git
    cd can-i-haz-houze/src
  2. 安装先决条件:
  3. 配置Azure OpenAI连接字符串:
    • 如果您使用本地Azure OpenAI,需要配置用户机密:
      cd CanIHazHouze.AppHost
      dotnet user-secrets set "ConnectionStrings:openai" "Endpoint=https://your-openai-resource.openai.azure.com/;ApiKey=your-super-secret-key"
      请将'your-openai-resource.openai.azure.com'替换为您的Azure OpenAI服务终端点,'your-super-secret-key'替换为您的API密钥。
  4. 启动应用:
    dotnet run --project CanIHazHouze.AppHost
    应用将通过.NET Aspire启动,并自动启动Cosmos DB和Azurite模拟器。您可以在浏览器中访问Aspire仪表盘(通常是'https://localhost:17001')查看服务状态。

服务器配置 (供MCP客户端使用)

该MCP服务器通过WebSocket协议提供服务。要连接MCP客户端(如Claude Desktop),您需要以下配置信息:

  • 服务器名称: 'canihazhouze' (建议名称,可自定义)
  • 连接命令: 'websocket' (指定使用WebSocket协议)
  • 连接参数: 'ws://localhost:5001/mcp' (MCP服务器的WebSocket地址)

请根据您的MCP客户端(例如Claude Desktop)的配置要求,以JSON格式提供这些信息。示例如下:

{
  "mcpServers": {
    "canihazhouze": {
      "command": "websocket",
      "args": ["ws://localhost:5001/mcp"],
      "description": "连接到本地运行的CanIHazHouze智能房贷审批系统的MCP服务,以便AI助手可以访问其提供的工具和资源。"
    }
  }
}

基本使用方法

一旦MCP服务器成功启动并通过您的MCP客户端进行了配置,您就可以通过AI助手与之交互:

  1. 启动MCP客户端: 确保您的MCP客户端已配置并连接到 'ws://localhost:5001/mcp'。
  2. 与AI助手对话: 您可以向AI助手提问或发出指令,例如:
    • "查询John Doe的账户余额。"
    • "上传一份名为 'salary_slip_may.pdf' 的工资单文档,并标记为 '收入'。"
    • "检查用户 'Jane Smith' 的抵押贷款文件是否齐全。"
    • "给我分析一下ID为 'xxxx-xxxx' 的文档,并提取关键信息。" AI助手将利用MCP服务器提供的工具来执行您的请求,并返回相应的结果。

信息

分类

商业系统