Itemit MCP Server

itemit-mcp

itemit-mcp は、資産管理のためのMCPサーバーであり、itemitの資産管理 API と Model Context Protocol（MCP）エコシステムをつなぎます。

uminai MCP チームが開発・保守しています。

---

目次

• 概要
• 前提条件
• itemit API 認証情報の取得
• インストールとビルド
• MCP クライアントの設定
• 環境変数
• 利用可能な MCP ツール
• 使用例
• レスポンス形式
• クレジットと参考情報

---

概要

itemit-mcp は、MCP プロトコル経由でitemitの資産管理プラットフォームを操作するためのツール群を提供します。プログラムから資産やロケーションを検索、作成、管理できるため、itemit をほかの MCP 対応システムと簡単に統合できます。利用可能なツールは以下のとおりです。

• アイテム一覧の取得
• 名前によるアイテム検索
• アイテムの作成
• ロケーション検索（そのロケーションにあるアイテム一覧を含む）

---

前提条件

• Node.js（v16 以上を推奨）
• itemitアカウントへのアクセス（API 認証情報の取得に必要）
• MCP クライアント（詳細はuminai MCPをご覧ください）

---

itemit API 認証情報の取得

この MCP サーバーを使用するには、itemitの API 認証情報が必要です。

• ITEMIT_API_KEY
• ITEMIT_USER_ID
• ITEMIT_USER_TOKEN
• ITEMIT_WORKSPACE_ID

itemitでサインアップまたはログインし、API ドキュメントを確認するか、サポートに問い合わせることで取得できます。

---

インストールとビルド

このリポジトリをクローンし、依存関係をインストールします。

npm install

プロジェクトをビルドします。

npm run build

---

MCP クライアントの設定

以下を MCP クライアントの設定（例：cline_mcp_settings.json）に追加します。

{
  "mcpServers": {
    "itemit-mcp": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "node",
      "args": [
        "/Users/<user>/Documents/itemit-mcp/build/index.js"
      ],
      "env": {
        "ITEMIT_API_KEY": "<YOUR_API_KEY>",
        "ITEMIT_USER_ID": "<YOUR_USER_ID>",
        "ITEMIT_USER_TOKEN": "<YOUR_USER_TOKEN>",
        "ITEMIT_WORKSPACE_ID": "<YOUR_WORKSPACE_ID>"
      }
    }
  }
}

プレースホルダーの値を実際の itemit 認証情報に置き換えてください。

---

環境変数

• ITEMIT_API_KEY：itemit API キー
• ITEMIT_USER_ID：itemit ユーザー ID
• ITEMIT_USER_TOKEN：itemit ユーザートークン
• ITEMIT_WORKSPACE_ID：itemit ワークスペース ID

これらは環境変数または .env ファイルに設定できます。

---

利用可能な MCP ツール

1. get-location-by-name

• 説明： itemit で名前を指定してロケーションを取得します。
• パラメーター：
  • name（string、必須）：検索するロケーション名
  • limit（integer、任意）：取得するロケーション数（デフォルト 25、最大 100）
  • skip（integer、任意）：スキップするロケーション数（デフォルト 0）
• 例：

  {
    "name": "Warehouse"
  }
  

---

2. search-item-by-name

• 説明： itemit で名前を指定してアイテムを検索します。
• パラメーター：
  • name（string、必須）：検索するアイテム名
  • size（integer、任意）：取得するアイテム数（デフォルト 15、最大 100）
  • page（integer、任意）：ページ番号（デフォルト 1）
• 例：

  {
    "name": "Laptop"
  }
  

---

3. create-item

• 説明： itemit にアイテムを作成します。
• パラメーター：
  • name（string、必須）：アイテム名
  • description（string、必須）：アイテムの説明
  • serial（string、必須）：アイテムのシリアル番号
• 例：

  {
    "name": "Projector",
    "description": "Epson HD Projector",
    "serial": "SN123456"
  }
  

---

4. get-reminders

• 説明： itemit からリマインダーを取得します。
• パラメーター： なし

---

5. get-items

• 説明： itemit からアイテムを取得します。
• パラメーター：
  • size（integer、任意）：取得するアイテム数（デフォルト 15、最大 100）
• 例：

  {
    "size": 10
  }
  

---

使用例

MCP クライアントを使ってこれらのツールを呼び出します。たとえば、アイテムを検索するには次のようにします。

{
  "tool": "search-item-by-name",
  "arguments": {
    "name": "Laptop"
  }
}

---

レスポンス形式

すべてのレスポンスは、itemit API のデータモデルに沿った構造化テキストまたは JSON として返されます。たとえば、検索が成功すると、次のような結果が返される場合があります。

{
  "content": [
    {
      "type": "text",
      "text": "Search results for \"Laptop\" (size=15):\n1. Dell XPS 13 (ID: 1234)\n2. MacBook Pro (ID: 5678)\n..."
    }
  ]
}

---

クレジットとその他のリソース

• uminai MCP チームによるプロジェクトです。
• itemit を利用しています。
• mcp.umin.ai で、さらに多くの MCP サーバーや連携機能をご覧ください。

---