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 服務器和集成信息請訪問 mcp.umin.ai。