Fishbowl MCP Server

Fishbowl MCP サーバー

Fishbowl Inventory API と連携するためのミドルウェアサーバーです。

概要

この MCP（Message Control Program）サーバーは、Fishbowl Inventory ソフトウェアと通信する RESTful API を提供します。認証やトークン管理を行い、すべてのリクエストを Fishbowl API にプロキシします。

機能

• Fishbowl API への自動認証
• Fishbowl の機能に簡単にアクセスできる API
• 部品、在庫、発注書、製造指図書に対応
• 発注書と製造指図書のメモ管理
• ベンダー、UOM、ユーザー、製品の各エンドポイント

前提条件

• Node.js 18 以上
• API にアクセスできる Fishbowl Inventory ソフトウェア
• Fishbowl のアクセス認証情報

ローカル開発環境のセットアップ

1. このリポジトリをクローンします。

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

2. 依存関係をインストールします。

   npm install
   

3. テンプレートを基に .env ファイルを作成します。

   cp .env.template .env
   

4. .env ファイルを編集し、Fishbowl の認証情報と API URL を設定します。

5. 開発サーバーを起動します。

   npm run dev
   

Railway へのデプロイ

1. アカウントをお持ちでない場合は、railway.app で Railway アカウントを作成します。

2. Railway CLI をインストールします。

   npm i -g @railway/cli
   

3. Railway にログインします。

   railway login
   

4. プロジェクトを初期化します。

   railway init
   

5. 環境変数を追加します。

   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
   

6. アプリケーションをデプロイします。

   railway up
   

7. デプロイしたアプリケーションを開きます。

   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 - 発注書または製造指図書のメモを取得
• 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 ユーザーに適切な権限があるか確認してください

2. 接続エラー：

   • FISHBOWL_API_URL が正しいことを確認してください
   • Fishbowl サーバーが稼働しており、MCP サーバーからアクセス可能であることを確認してください
   • ファイアウォールやネットワークの制限がないか確認してください

3. Railway でのデプロイの問題：

   • すべての環境変数が正しく設定されていることを確認してください
   • エラーがないかログを確認してください：railway logs
   • Railway プロジェクトに十分なリソースがあることを確認してください

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは ISC ライセンスの下でライセンスされています。