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（字符串，必填）：要搜索的位置名称
  • 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 服务和集成。

---