Snipe-IT (Mojood Connect)

Snipe-IT MCP サーバー

資産について、普段の言葉で Claude に質問できます。LAP-0142 のノートパソコンを誰が使っているか、今月監査が必要なものは何か、在庫が少なくなっているものは何か、といった質問ができます。同じチャットから資産の貸し出しと返却も行えます。変更の前には確認ステップがあります。

Snipe-IT の動作デモとして、Mojood Connect が開発しました。REST API を通じて、あらゆる Snipe-IT で動作します。このリポジトリには、架空の会社 Harbor Trading のサンプルデータを含むローカルの Snipe-IT が含まれているため、実際のインスタンスに触れることなく試せます。

ツール

ツール	機能	変更を加えますか？
find_asset	タグ、シリアル番号、モデル、または所持者から資産を検索します。ステータス、所持者、場所、次回監査日、保証終了日を確認できます	いいえ
whats_assigned_to	1 人に貸し出されているすべてのものを表示します。同じ名前の人が複数いる場合は、対象者を尋ねます	いいえ
needs_attention	期限超過・期限到来の監査、期限超過・返却間近の貸し出し、保証終了間近、使用停止中の資産を確認します	いいえ
low_stock	最低数量を下回っている消耗品とアクセサリーを確認します	いいえ
check_out_asset	資産を人に割り当てます	はい。確認後に実行します
check_in_asset	資産を所持者から返却します	はい。確認後に実行します

安全な変更方法。 check_out_asset または check_in_asset を confirmation なしで呼び出しても、何も変更されません。代わりに、簡潔な概要（「LAP-0160（ThinkPad T14 Gen 5）を Sara Al-Qahtani（財務部、Dammam HQ）に貸し出します。」）と一度限りのコードを返します。同じリクエストにそのコードを添えて 10 分以内に再送した場合にのみ、変更が実行されます。コードは一度だけ使用でき、発行対象となったリクエストに限って有効です。サーバーの指示により、モデルは概要を提示し、ユーザーの承認を待ちます。すべての変更は、Snipe-IT 独自の貸し出し・返却エンドポイントを通じて、「via Claude (Mojood Connect demo)」というメモ付きで行われるため、担当者が行った変更と同じように、資産の履歴に記録されます。

サーバーは API トークンを所有するユーザーとして動作し、そのユーザーの Snipe-IT 権限が適用されます。

ローカルで試す

Docker（Compose を含む）、uv、Python 3.13 が必要です。

scripts/reset.sh                         # local Snipe-IT on http://localhost:8088, filled with the SAMPLE company
uv run --env-file .env snipeit-mcp       # MCP server on http://127.0.0.1:8002/mcp (Streamable HTTP)

scripts/reset.sh はすべてのパスワードと API トークンを自動生成し、Git の追跡対象外である docker/.env と .env に保存します。何も表示されません。いつでも再実行して、サンプルデータを初期状態からやり直せます。すべて 127.0.0.1 のみで待ち受けます。scripts/up.sh はデータに触れることなく、再起動後に再び起動します。

Claude Desktop： フォルダーへのパスを指定して、次の内容を claude_desktop_config.json（Settings › Developer）に追加します。

{
  "mcpServers": {
    "snipe-it": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/snipeit-mcp", "--env-file", "/path/to/snipeit-mcp/.env", "snipeit-mcp", "--stdio"]
    }
  }
}

次のように尋ねてみてください。「LAP-0142 を使っているのは誰ですか？その人がほかに使っているものは何ですか？」「今月、対応が必要なものは何ですか？」「在庫が少なくなっているものは何ですか？」「予備の ThinkPad を Sara に貸し出してください。」

独自の Snipe-IT を使う場合： SNIPEIT_URL と SNIPEIT_TOKEN（Snipe-IT プロフィールから取得した個人用 API キー）を設定し、SNIPEIT_SAMPLE=0 にします。

サンプルの会社

Harbor Trading：3 つの拠点（Dammam HQ、Riyadh office、Jeddah warehouse）、15 人、48 点の資産（ノートパソコン、モニター、電話、倉庫用スキャナー、プリンター）、7 点の在庫品があります。日付はデータの投入日を基準に設定されているため、監査の期限超過と期限到来、12 日遅れの貸し出し用ノートパソコン 1 台、4 日後に返却予定のもの 1 台、保証終了間近のもの、修理中のノートパソコン 1 台、最低数量を下回る品目 3 点が常にあります。人名、シリアル番号、価格は架空のものです。

テスト

uv run pytest                            # unit tests (a fake Snipe-IT API), plus live tests when the local Snipe-IT runs

本番バージョンで追加される機能

このデモは 1 つの API トークンでサインインします。Snipe-IT の顧客向け本番サーバーでは、各ユーザーが自身の Snipe-IT アカウントでサインインできるようにし、Claude が各ユーザーに表示を許可された情報だけを見られるようにします。また、すべてのツール呼び出しを記録する監査ログ付きのホスティングや、API のさらなる機能（ライセンス、コンポーネント、メンテナンス、リクエスト）も追加します。これが Mojood Connect の開発しているものです。

ライセンス

Apache 2.0。Snipe-IT は Grokability, Inc. の商標です。このプロジェクトは Grokability によって作成または承認されたものではありません。