项目简介
"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实现实时通信。
安装步骤
- 克隆仓库:
git clone https://github.com/abossard/can-i-haz-houze.git cd can-i-haz-houze/src - 安装先决条件:
- .NET 9.0 SDK
- Docker Desktop (用于运行Cosmos DB和Azurite模拟器)
- Azure CLI
- Azure Developer CLI (azd)
- 任意您偏好的IDE (如VS 2022, Rider, VS Code)。
- 配置Azure OpenAI连接字符串:
- 如果您使用本地Azure OpenAI,需要配置用户机密:
请将'your-openai-resource.openai.azure.com'替换为您的Azure OpenAI服务终端点,'your-super-secret-key'替换为您的API密钥。cd CanIHazHouze.AppHost dotnet user-secrets set "ConnectionStrings:openai" "Endpoint=https://your-openai-resource.openai.azure.com/;ApiKey=your-super-secret-key"
- 如果您使用本地Azure OpenAI,需要配置用户机密:
- 启动应用:
应用将通过.NET Aspire启动,并自动启动Cosmos DB和Azurite模拟器。您可以在浏览器中访问Aspire仪表盘(通常是'https://localhost:17001')查看服务状态。dotnet run --project CanIHazHouze.AppHost
服务器配置 (供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助手与之交互:
- 启动MCP客户端: 确保您的MCP客户端已配置并连接到 'ws://localhost:5001/mcp'。
- 与AI助手对话: 您可以向AI助手提问或发出指令,例如:
- "查询John Doe的账户余额。"
- "上传一份名为 'salary_slip_may.pdf' 的工资单文档,并标记为 '收入'。"
- "检查用户 'Jane Smith' 的抵押贷款文件是否齐全。"
- "给我分析一下ID为 'xxxx-xxxx' 的文档,并提取关键信息。" AI助手将利用MCP服务器提供的工具来执行您的请求,并返回相应的结果。
信息
分类
商业系统