Itemit MCP

🚀 itemit - mcp

itemit - mcp は、資産追跡用の MCP サーバーです。itemit の資産管理 API とモデルコンテキストプロトコル (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 (文字列、必須): 検索する場所の名前
  • limit (整数、オプション): 取得する場所の数 (デフォルト 25、最大 100)
  • skip (整数、オプション): スキップする場所の数 (デフォルト 0)
• 例:

  {
    "name": "Warehouse"
  }
  

2. search - item - by - name

• 説明: itemit で名前でアイテムを検索します。
• パラメーター:
  • name (文字列、必須): 検索するアイテムの名前
  • size (整数、オプション): 取得するアイテムの数 (デフォルト 15、最大 100)
  • page (整数、オプション): ページ番号 (デフォルト 1)
• 例:

  {
    "name": "Laptop"
  }
  

3. create - item

• 説明: itemit でアイテムを作成します。
• パラメーター:
  • name (文字列、必須): アイテムの名前
  • description (文字列、必須): アイテムの説明
  • serial (文字列、必須): アイテムのシリアル番号
• 例:

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

4. get - reminders

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

5. get - items

• 説明: itemit からアイテムを取得します。
• パラメーター:
  • size (整数、オプション): 取得するアイテムの数 (デフォルト 15、最大 100)
• 例:

  {
    "size": 10
  }
  

💻 使用例

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

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

📄 レスポンス形式

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

{
  "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 サーバーと統合を発見してください。