MCP サーバー + NANDA レジストリ + NANDA ホスト クライアントを使用したオフィス用品在庫 NANDA サービス
モデルコンテキストプロトコル（MCP）サーバーコードを使用して、事務用品の在庫情報を提供するNANDAサービスを作成します。このサービスにより、AIアシスタントはMCP標準に基づいて事務用品に関する情報を照会・取得できるようになります。クラウドホストサーバーとWebベースのNANDAホストクライアントを使用します。ローカルサーバーのインストールは不要です。
同じフレームワークを使用して、あらゆる標準在庫用の消費者向け Web アプリを展開できます。
概要
このプロジェクトは、MCPサーバーコードを使用して、CSVファイルからオフィス在庫データを提供するNANDAサービスを実装します。AIアシスタントが以下の機能を実行できるようにするツールを提供します。
在庫にあるすべてのアイテムのリストを取得します
名前で特定のアイテムの詳細情報を取得します
Related MCP server: Zaturn
前提条件
Python 3.9以上
requirements.txtにリストされている依存関係
このリポジトリ内のファイル
officesupply.py: メインサーバーの実装inventory.csv: オフィス用品の在庫データを含むCSVファイルbuild.sh: 環境設定用のスクリプトrun.sh: サーバーを実行するためのスクリプトrequirements.txt: Python の依存関係のリスト
クイックスタート
ローカルセットアップ
このリポジトリをクローンします:
git clone https://github.com/aidecentralized/nanda-servers.git cd office-supplies-shop-server以下のいずれかの環境設定オプションを選択します。
オプションA: Python venvを使用する
Python 仮想環境を作成します。
python -m venv venv仮想環境をアクティブ化します。
Linux/macOSの場合:
source venv/bin/activateWindowsの場合:
venv\Scripts\activate
依存関係をインストールします:
pip install -r requirements.txt
オプションB: Condaを使用する
新しい conda 環境を作成します。
conda create --name inventory_env python=3.11conda 環境をアクティブ化します。
conda activate inventory_env依存関係をインストールします:
pip install -r requirements.txt
ローカルでサーバーを実行してテストする
上記のいずれかのオプションを使用して環境を設定した後:
サーバーを実行します。
python officesupply.pyサーバーは次の場所で利用できます: http://localhost:8080
MCP Inspectorによるテスト
MCP Inspector をインストールします。
npx @modelcontextprotocol/inspectorインスペクタから提供されたURLをブラウザで開きます
SSEトランスポートタイプを使用して接続する
末尾に
/sseを付けてサーバーの URL を入力します (例:http://localhost:8080/sse)利用可能なツールをテストします。
get_items: インベントリ内のすべてのアイテム名を一覧表示しますget_item_info: 特定のアイテムの詳細を取得します
CSVデータ形式
サーバーは、少なくとも次の列を含むinventory.csvファイルを想定しています。
item_name: 在庫アイテムの名前
get_item_infoによって返されるアイテムの詳細には追加の列が含まれます。
この範囲内で、要件に合わせて CSV ファイルを編集することができ、MCP サーバーも CSV ファイルに対して機能するはずです。
展開
クラウド導入の準備
リポジトリに次の内容が含まれていることを確認してください。
すべてのコードファイル
requirements.txtbuild.shおよびrun.shスクリプト
シェル スクリプトに実行権限を設定します。
chmod +x build.sh run.shWindowsの場合は、
wsl chmod +x build.sh run.sh
AWSアカウントを作成する
AWS AppRunnerへのデプロイ
AWSアカウントを作成する
請求用のクレジットカードを追加する
AWS AppRunner ( https://console.aws.amazon.com/apprunner ) にアクセスします。
ログインしてください（まだログインしていない場合）
App Runnerダッシュボードにアクセスすると、ページの右上近くに青い「サービスを作成」ボタンが表示されます。それをクリックしてください。
ソースコードリポジトリから新しいサービスを作成する
サービスを設定します。
Python 3.11 ランタイム
ビルドコマンド:
./build.sh実行コマンド:
./run.shポート: 8080
デプロイして完了を待つ
MCP Inspector でパブリックエンドポイントをテストする
NANDAレジストリへの登録
ログインまたはアカウントを作成
「新しいサーバーを登録」をクリックします
詳細を入力してください:
サーバー名
説明
パブリックエンドポイント URL (
/sseなし)タグとカテゴリ
サーバーを登録する
ブラウザベースのクライアントであるNANDA Hostでの使用
nanda.mit.eduをご覧ください
NANDAホストへ
Anthropic APIキーを追加する
レジストリでMCPサーバーを探す
ホストに追加する
サーバーの機能を使用する質問をしてテストします
トラブルシューティング
CSVファイルが適切にフォーマットされていることを確認してください
展開前にローカルでサーバーをテストする
登録する前に、MCP Inspector でパブリックエンドポイントが機能することを確認してください。
デプロイメントが失敗した場合はAWSのログを確認する
追加リソース
MCP サーバーの設定と使用の手順については、次のビデオ チュートリアルをご覧ください。 
謝辞
NANDA Serversリポジトリに基づいています。ProjectNandaについてはhttps://nanda.mit.eduをご覧ください。