Fishbowl-Test

鱼缸MCP服务器

一个中间件服务器，用于与Fishboll库存API集成。

概述

此MCP（消息控制程序）服务器提供了一个RESTful API，可与您的Fishboll库存软件进行通信。它处理身份验证、令牌管理，并将所有请求代理到Fishbowl API。

特性

• 使用Fishbowl API进行自动身份验证
• 简化了API对Fishbowl功能的访问
• 支持零件、库存、采购订单和制造订单
• PO和MO的备忘录管理
• 供应商、计量单位、用户和产品端点

先决条件

• Node.js 18或更高版本
• 可访问API的Fishbowl库存软件
• Fishbowl的访问凭据

地方发展设置

1. 克隆此存储库：

   git clone https://your-repo-url/fishbowl-mcp-server.git
   cd fishbowl-mcp-server

1. 安装依赖项：

   npm install

1. 创建一个 .env 基于模板的文件：

   cp .env.template .env

1. 编辑 .env 文件与您的Fishbowl凭证和API URL。

1. 启动开发服务器：

   npm run dev

部署到铁路

1. 在以下网址创建铁路帐户 railway应用程序 如果你没有。

1. 安装铁路CLI：

   npm i -g @railway/cli

1. 登录铁路：

   railway login

1. 初始化您的项目：

   railway init

1. 添加环境变量：

   railway variables set FISHBOWL_API_URL=http://your-fishbowl-server-address:port
   railway variables set FISHBOWL_APP_NAME="MCP Server"
   railway variables set FISHBOWL_APP_ID=101
   railway variables set FISHBOWL_USERNAME=your-username
   railway variables set FISHBOWL_PASSWORD=your-password

1. 部署您的应用程序：

   railway up

1. 打开已部署的应用程序：

   railway open

API终点

认证

• POST /api/login -登录Fishbowl API
• POST /api/logout -从Fishbowl API注销

零件和库存

• GET /api/parts -搜索零件
• GET /api/parts/inventory -获取零件库存
• GET /api/parts/:id/best-cost -获得零件的最佳成本
• POST /api/parts/:id/inventory/add -为零件添加库存
• POST /api/parts/:id/inventory/cycle -循环盘点
• POST /api/parts/:id/inventory/scrap -废品库存

采购订单

• GET /api/purchase-orders -列出采购订单
• GET /api/purchase-orders/:id -按ID获取采购订单
• POST /api/purchase-orders -创建采购订单
• POST /api/purchase-orders/:id -更新采购订单
• POST /api/purchase-orders/:id/issue -发出采购订单
• POST /api/purchase-orders/:id/unissue -统一采购订单
• POST /api/purchase-orders/:id/close-short -关闭采购订单短缺
• POST /api/purchase-orders/:id/void -作废采购订单
• DELETE /api/purchase-orders/:id -删除采购订单

生产订单

• GET /api/manufacture-orders -列出制造订单
• GET /api/manufacture-orders/:id -按ID获取生产订单
• POST /api/manufacture-orders -创建生产订单
• POST /api/manufacture-orders/:id/issue -发出制造订单
• POST /api/manufacture-orders/:id/unissue -统一制造订单
• POST /api/manufacture-orders/:id/close-short -短时间关闭生产订单
• DELETE /api/manufacture-orders/:id -删除生产订单

备忘录

• GET /api/{type}/:id/memos -获取PO或MO的备忘录
• GET /api/{type}/:id/memos/:memoId -获取特定备忘录
• POST /api/{type}/:id/memos -创建备忘录
• POST /api/{type}/:id/memos/:memoId -更新备忘录
• DELETE /api/{type}/:id/memos/:memoId -删除备忘录

哪里 {type} 可以是 purchase-orders 或 manufacture-orders

其他终点

• GET /api/products/:id/best-price -获得产品的最优价格
• GET /api/uoms -列出计量单位
• GET /api/vendors -列出供应商
• GET /api/users -列出用户
• GET /api/health -检查服务器运行状况和身份验证状态

安全考虑

• 使用环境变量安全地存储您的Fishbowl凭据
• 在生产环境中使用HTTPS加密传输中的数据
• 服务器会自动处理身份验证令牌，但要注意它们会过期
• 考虑在生产环境中为MCP服务器实施额外的身份验证

故障排除

常见问题

1. 身份验证失败：

- 验证.env文件中的Fishbowl凭据 - 确保已启用并可访问Fishbowl API - 检查您的Fishbowl用户是否具有适当的权限

1. 连接错误：

- 验证FISHBOWL_API_URL是否正确 - 确保您的Fishbowl服务器正在运行，并且可以从MCP服务器访问 - 检查是否有防火墙或网络限制

1. 铁路部署问题：

- 验证所有环境变量是否设置正确 - 检查日志是否有任何错误： railway logs - 确保您的铁路项目有足够的资源

贡献

欢迎投稿！请随时提交拉取请求。

许可证

该项目根据ISC许可证获得许可。