钱小姐
钱小姐 是一个项目，该项目使用 nutrient-dws MCP服务器。它允许用户使用简单直观的界面轻松地与Nutriental DWS API交互。该项目旨在易于使用和部署，使其可供广大用户访问。
该项目包括一个Quart API和一个React前端，以方便与Nutriental DWS API交互，以及Docker部署脚本。使用上述脚本，API可以轻松地部署在Docker容器中，而无需任何额外的配置或安装依赖项。
项目结构
📁 moneypenny
├── 📁 moneypenny-api # Moneypenny Quart API
│ ├── 📁 resource # Various resources used by the running application
│ │ ├── 📁 document # Sandbox documents
│ │ └── 📁 script # Scripts
│ ├── 📁 src # Source code
│ │ ├── 📁 api # API endpoints implementation
│ │ ├── 📁 common # Common functions and variables
│ │ ├── 📁 domain # Domain models
│ │ ├── 📁 factory # Factories
│ │ ├── 📁 graph # LangGraph implementations
│ │ ├── 📁 schema # Schemas used throughout the application
│ │ ├── 📁 service # Services
│ │ ├── 📁 util # Utility functions
│ │ └── logger_config.yaml # Logger configuration
│ ├── Pipfile # Python dependencies
│ └── settings.toml # Application settings
├── 📁 moneypenny-frontend # Moneypenny React frontend
├── 📁 moneypenny-deployment # Moneypenny deployment scripts
│ └── 📁 docker # Docker configuration
│ ├── 📁 compose # Docker Compose files and relevant .env files
│ ├── 📁 image # Docker images
│ ├── deploy.bat # Windows deployment script
│ ├── deploy.ps1 # PowerShell deployment script
│ └── deploy.sh # GNU/Linux and MacOS deployment script
├── README.md
├── LICENSE
└── .gitignore部署
为了部署Moneypenny服务，请确保您有 码头工人 和 安装在您的机器上。一旦这些依赖关系得到满足，请按照以下步骤操作：
- 添加
.env文件在moneypenny-deployment/docker/compose包含相关环境变量的文件夹。这是一个例子.env文件：
# Description: Environment variables for docker-compose
MONEYPENNY_API_PORT=5001
MONEYPENNY_FRONTEND_PORT=5002
OPENAI_API_KEY=your_openai_api_key
NUTRIENT_DWS_API_KEY=your_nutrient_dws_api_key- 导航至
moneypenny-deployment/docker文件夹。
- 使用实用程序脚本
deploy.sh部署服务（注意：在下面的所有示例中，都使用了GNU/Linux和MacOS版本的脚本，但是也有Windows版本可用。请注意，Windows版本的脚本没有GNU/Linux和MacOS版本进行广泛的测试）：
./deploy.sh up就是这样！上面的命令将在Docker容器中构建和运行所有相关服务。将部署以下服务：
- Moneypenny API -用于与Moneypenny功能交互的API服务：
- 可在 http://localhost:5001 （默认值）。 - API文件可在以下网址获取： - 斯瓦格： http://localhost:5001/docs - 日志可在 moneypenny-api/src/moneypenny.log. - 源代码和资源（文档）作为Docker卷挂载，因此对源代码或资源所做的任何更改都将反映在正在运行的容器中，反之亦然。由于我们使用的是开发Quart服务器，对源代码所做的任何更改都会自动重新启动服务器。
- 彭尼前端 -一个简单的基于React的前端，用于与Moneypenny API交互：
- 可在 http://localhost:5002 （默认值）。 - 源代码作为Docker卷挂载，因此对源代码所做的任何更改都会反映在正在运行的容器中，反之亦然。由于我们使用的是Vite开发服务器，对源代码所做的任何更改都会自动重新加载前端。
停止服务
要停止所有服务，请使用以下命令：
./deploy.sh down部署选项
为了更改默认行为 deploy.sh，使用以下选项：
-b或--build：明确构建所有相关容器。默认值为false.-e或--environment：默认值为local.其他环境(dev,stage,prod等等尚未得到支持）。
例如，为了在开发环境中部署服务并强制构建所有相关容器，请使用以下命令：
./deploy.sh up -b -e dev运行以下命令可以找到完整的选项列表：
./deploy.sh --help依赖项
Moneypenny API
为了在本地运行Moneypenny API（没有Docker），请确保安装了以下依赖项（包括 Pipfile 将负责安装相关的Python包）：
- Python 3.11： 一种高级编程语言。
- 管道： Python依赖管理工具。
- 季度： 基于Flask的Python web微框架。
- Quart架构 -使用Pydantic验证请求和响应数据的Quart扩展。
- Quart CORS -用于处理跨源资源共享（CORS）的Quart扩展。
- 高血压： Quart的ASGI服务器。
- 山药： Python的YAML解析器和发射器。
- dynaconf： -配置管理。
- 熊猫： 数据操作和分析库。
- 郎链： 一个用于开发由语言模型驱动的应用程序的框架。
- LangChain MCP适配器： -LangChain的MCP适配器。
- LangChain OpenAI -LangChain的OpenAI集成。
- LangGraph ： 使用语言模型构建应用程序的框架。
彭尼前端
为了在本地运行Moneypenny前端（无需Docker），请确保安装了以下依赖项（包括 package.json 将负责安装相关的Node包）：
- JavaScript运行时基于Chrome的V8 JavaScript引擎构建。
- 节点包管理器。
- 快： 下一代前端工具。
- 反应： 用于构建用户界面的JavaScript库。
- TypeScript： 一种基于JavaScript的强类型编程语言。
- Axios： 浏览器和node.js的基于Promise的HTTP客户端。
- 顺风： 一个实用的CSS框架，用于快速UI开发。
- postcss： 一个使用JavaScript插件转换CSS的工具。
- shadcn/ui： 一组使用Radix UI和Tailwind CSS构建的漂亮、可访问的组件。
- 自动预混合器： 一个PostCSS插件，用于解析CSS并使用“我可以使用”中的值添加供应商前缀。
用法
Moneypenny API
如果您只想使用API，您可以使用以下工具与Moneypenny API交互 邮递员 或 卷曲。如果更方便，您还可以使用API交互式文档，网址为 http://localhost:5001/docs （斯瓦格）。
彭尼前端
部署服务后，您可以访问Moneypenny前端 http://localhost:5002.前端提供了一个用于与Moneypenny API交互的简单接口。