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。